@appaflytech/zeyrek-ai-mcp 0.0.32 → 0.0.33
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.env.example +15 -0
- package/dist/config.js +11 -0
- package/dist/index.js +2 -0
- package/dist/knowledge/access.js +802 -0
- package/dist/knowledge/case.js +41 -0
- package/dist/knowledge/componentCatalog.js +82 -213
- package/dist/knowledge/componentEvents.js +21 -19
- package/dist/knowledge/connectDataBind.js +819 -0
- package/dist/knowledge/connectDataDefinition.js +341 -0
- package/dist/knowledge/connectDataExecute.js +93 -0
- package/dist/knowledge/connectDataRules.js +128 -0
- package/dist/knowledge/decision.js +121 -0
- package/dist/knowledge/expressionPrelude.js +59 -0
- package/dist/knowledge/layoutSummary.js +140 -2
- package/dist/knowledge/microserviceParameters.js +58 -0
- package/dist/knowledge/mining.js +94 -0
- package/dist/knowledge/mobileComponentCatalog.js +864 -0
- package/dist/knowledge/mobileComponentEvents.js +239 -0
- package/dist/knowledge/mobileStore.js +227 -0
- package/dist/knowledge/normalize.js +121 -35
- package/dist/knowledge/platform/lint.js +385 -0
- package/dist/knowledge/platform/mobile.js +142 -0
- package/dist/knowledge/platform/mobileLayoutLint.js +324 -0
- package/dist/knowledge/platform/mobileRules.js +231 -0
- package/dist/knowledge/platform/mobileSpacing.js +82 -0
- package/dist/knowledge/platform/mobileTabs.js +108 -0
- package/dist/knowledge/platform/nativeBoxModel.js +44 -0
- package/dist/knowledge/platform/profile.js +25 -0
- package/dist/knowledge/platform/resolve.js +122 -0
- package/dist/knowledge/platform/web.js +39 -0
- package/dist/knowledge/process.js +510 -0
- package/dist/knowledge/rowFilter.js +43 -0
- package/dist/knowledge/rules.js +291 -19
- package/dist/knowledge/styleResolve.js +55 -38
- package/dist/knowledge/styleResolveNative.js +527 -0
- package/dist/knowledge/themeResolve.js +3 -3
- package/dist/observability/trace.js +1 -1
- package/dist/platform/argumentAliases.js +128 -0
- package/dist/platform/bodyFile.js +103 -0
- package/dist/platform/capture/actions.js +333 -0
- package/dist/platform/capture/browser.js +1 -0
- package/dist/platform/{screenshot.js → capture/capture.js} +81 -519
- package/dist/platform/capture/console-log.js +122 -0
- package/dist/platform/capture/index.js +11 -0
- package/dist/platform/capture/readiness.js +103 -0
- package/dist/platform/capture/summary.js +77 -0
- package/dist/platform/capture/target.js +5 -0
- package/dist/platform/capture/targets/studio-mobile.js +15 -0
- package/dist/platform/capture/targets/studio-web.js +5 -0
- package/dist/platform/diagnostics.js +10 -4
- package/dist/platform/domSummary.js +1 -1
- package/dist/platform/http.js +23 -7
- package/dist/platform/impersonation.js +45 -0
- package/dist/platform/jsonArray.js +24 -0
- package/dist/platform/responses.js +6 -2
- package/dist/platform/schemaReadMemory.js +60 -0
- package/dist/platform/secrets.js +9 -0
- package/dist/platform/strictArguments.js +68 -12
- package/dist/platform/tokenVault.js +187 -4
- package/dist/resources/examples/bpm-gorev-kontrol.json +294 -0
- package/dist/resources/examples/bpm-iso-dokuman.json +228 -0
- package/dist/resources/examples/bpm-satinalma.json +376 -0
- package/dist/resources/examples/connect-data-convert-verify.json +107 -0
- package/dist/resources/examples/connect-data-dropdown-roles.json +66 -0
- package/dist/resources/examples/connect-data-edit-m2m.json +73 -0
- package/dist/resources/examples/connect-data-query-params.json +50 -0
- package/dist/resources/examples/connect-data-table-entity.json +147 -0
- package/dist/resources/examples/connect-data-workflow-microservice.json +65 -0
- package/dist/resources/examples/layout-app-shell.json +229 -707
- package/dist/resources/examples/mobile-app-shell-drawer.json +244 -0
- package/dist/resources/examples/mobile-app-shell-stack.json +157 -0
- package/dist/resources/examples/mobile-app-shell-tab.json +208 -0
- package/dist/resources/examples/mobile-form-screen.json +365 -0
- package/dist/resources/examples/mobile-list-detail-form.json +703 -0
- package/dist/resources/examples/page-flex-sections.json +1 -1
- package/dist/resources/guides/access.md +796 -0
- package/dist/resources/guides/bpm.md +686 -0
- package/dist/resources/guides/case.md +153 -0
- package/dist/resources/guides/component.md +10 -2
- package/dist/resources/guides/decision.md +185 -0
- package/dist/resources/guides/expressions.md +14 -5
- package/dist/resources/guides/functions.md +1 -1
- package/dist/resources/guides/layout.md +55 -58
- package/dist/resources/guides/microservice.md +9 -2
- package/dist/resources/guides/middleware.md +34 -2
- package/dist/resources/guides/mobile-layout.md +193 -0
- package/dist/resources/guides/mobile.md +578 -0
- package/dist/resources/guides/page.md +221 -92
- package/dist/resources/guides/theme.md +8 -2
- package/dist/resources/guides/translation.md +1 -1
- package/dist/resources/guides/workflow.md +7 -1
- package/dist/resources/read.js +41 -0
- package/dist/resources/schema-fingerprint.json +4 -4
- package/dist/resources/schemas/AccessExplanationDto.json +144 -0
- package/dist/resources/schemas/AccessMatrixDto.json +170 -0
- package/dist/resources/schemas/AccessPermissionDto.json +57 -0
- package/dist/resources/schemas/AccessPolicyDto.json +223 -0
- package/dist/resources/schemas/AccessResourceDto.json +86 -0
- package/dist/resources/schemas/AppSessionDto.json +53 -0
- package/dist/resources/schemas/ConnectDataDescribeDto.json +344 -0
- package/dist/resources/schemas/ConnectDataRequestModel.json +202 -0
- package/dist/resources/schemas/ConnectDataResultDto.json +421 -0
- package/dist/resources/schemas/ConnectorCredentialDto.json +70 -0
- package/dist/resources/schemas/ConvertConnectDataToMicroserviceCommand.json +37 -0
- package/dist/resources/schemas/CreateAccessPolicyCommand.json +209 -0
- package/dist/resources/schemas/CreateDecisionCommand.json +221 -0
- package/dist/resources/schemas/CreateProcessDefinitionCommand.json +1337 -0
- package/dist/resources/schemas/DecisionDto.json +302 -0
- package/dist/resources/schemas/DetachConnectDataMicroserviceCommand.json +28 -0
- package/dist/resources/schemas/ExplainAccessQuery.json +33 -0
- package/dist/resources/schemas/GenerateProcessDocumentCommand.json +116 -0
- package/dist/resources/schemas/GlobalFunctionUpdateResultDto.json +3 -1
- package/dist/resources/schemas/MicroserviceDto.json +2 -2
- package/dist/resources/schemas/OrganizationProjectDto.json +335 -0
- package/dist/resources/schemas/OrganizationSchemaDto.json +196 -0
- package/dist/resources/schemas/OrganizationSchemaVersionDto.json +207 -0
- package/dist/resources/schemas/PatchProcessDefinitionCommand.json +76 -0
- package/dist/resources/schemas/ProcessDefinitionDto.json +1480 -0
- package/dist/resources/schemas/ProcessSimulationDto.json +96 -0
- package/dist/resources/schemas/SaveConnectorCredentialCommand.json +90 -0
- package/dist/resources/schemas/SaveProcessEventSourceCommand.json +61 -0
- package/dist/resources/schemas/SaveProcessMailSourceCommand.json +89 -0
- package/dist/resources/schemas/SignProcessTaskCommand.json +73 -0
- package/dist/resources/schemas/SimulateProcessDefinitionQuery.json +92 -0
- package/dist/resources/schemas/StartMobileBuildCommand.json +54 -0
- package/dist/resources/schemas/UpdateAccessPolicyCommand.json +209 -0
- package/dist/resources/schemas/UpdateDecisionCommand.json +216 -0
- package/dist/resources/schemas/UpdateProcessDefinitionCommand.json +1357 -0
- package/dist/resources/schemas/UpsertMobileStoreSettingsCommand.json +259 -0
- package/dist/resources/schemas/ValidateProcessDefinitionQuery.json +1339 -0
- package/dist/server.js +7 -1
- package/dist/tools/accessOperations.js +135 -0
- package/dist/tools/accessPolicies.js +170 -0
- package/dist/tools/accessRuntime.js +203 -0
- package/dist/tools/applications.js +60 -3
- package/dist/tools/bpm.js +343 -0
- package/dist/tools/bpmGovernance.js +266 -0
- package/dist/tools/bpmOperations.js +230 -0
- package/dist/tools/bpmReporting.js +154 -0
- package/dist/tools/bpmRouting.js +150 -0
- package/dist/tools/bpmRuntime.js +396 -0
- package/dist/tools/case.js +178 -0
- package/dist/tools/caseRuntime.js +89 -0
- package/dist/tools/components.js +103 -12
- package/dist/tools/connectData.js +449 -0
- package/dist/tools/connectors.js +193 -0
- package/dist/tools/datasources.js +1 -1
- package/dist/tools/decisions.js +206 -0
- package/dist/tools/designSchemaPatch.js +22 -16
- package/dist/tools/externalComponents.js +25 -4
- package/dist/tools/flows.js +79 -6
- package/dist/tools/layouts.js +44 -12
- package/dist/tools/microservices.js +32 -10
- package/dist/tools/mobile.js +221 -0
- package/dist/tools/mobileStore.js +268 -0
- package/dist/tools/modules.js +48 -0
- package/dist/tools/organizationStructure.js +137 -0
- package/dist/tools/pages.js +391 -92
- package/dist/tools/platformInfo.js +7 -2
- package/dist/tools/profileWrite.js +92 -0
- package/dist/tools/rows.js +7 -1
- package/dist/tools/schemaOps.js +33 -1
- package/dist/tools/screenWrite.js +15 -7
- package/dist/tools/screens.js +90 -3
- package/dist/tools/variables.js +11 -5
- package/package.json +2 -2
- package/dist/knowledge/boxSections.js +0 -184
|
@@ -32,7 +32,7 @@ export const TABLE_COLUMN_TYPE_NOTE = "KOLON TİPİ SÖZLÜĞÜ (bekler → çiz
|
|
|
32
32
|
"tags: [{ value, color }] dizisi ya da metin dizisi → çok rozet, renk SATIR VERİSİNDEN (serbest hex burada geçer), sığmayanlar +N ile toplanır. " +
|
|
33
33
|
"action: veri kolonu DEĞİL — aksiyon sütunu ayrı çizilir; kolon tanımında seçilirse ham değer metin olarak görünür.";
|
|
34
34
|
export const STYLE_GROUP_NOTES = {
|
|
35
|
-
surfaceStyle: "{ background, radius, borderTop, borderRight, borderBottom, borderLeft, shadow, contentOverflow(visible|hidden|auto), opacity(0–100 yüzde; 100/boş yazılmaz) }. radius: tema kademesi ('var(--ng-radius-md)'; sm/lg 'Border radius'un oranı, md temanın kendisi), tek uzunluk ('18px') YA DA dört köşe ('90px 14px 14px 14px' — sol-üst, sağ-üst, sağ-alt, sol-alt). KENARLIK YÖN BAŞINADIR: her yön kendi CSS kısayolunu taşır ('1px solid var(--ng-border-primary)'), 'none' o kenarı kapatır; eski borderWidth/borderStyle/borderColor üçlüsü EMEKLİ (yalnız hiçbir yön yazılmamışsa okunur). shadow: çok katmanlı `box-shadow` metni ('0px 2px 5px 0px rgba(0,0,0,.2), inset 8px 5px 7px 0px #000'), tema token'ı ('var(--ng-shadow-md)') ya da eski preset anahtarı (none|sm|md|lg).",
|
|
35
|
+
surfaceStyle: "{ background, radius, borderTop, borderRight, borderBottom, borderLeft, shadow, contentOverflow(visible|hidden|auto), opacity(0–100 yüzde; 100/boş yazılmaz), rotate(derece, −360…360), scale(YÜZDE 10–500; 100 aynı boy ve varsayılan — 1.1 değil 110), translateX/translateY(px, −1000…1000) }. radius: tema kademesi ('var(--ng-radius-md)'; sm/lg 'Border radius'un oranı, md temanın kendisi), tek uzunluk ('18px') YA DA dört köşe ('90px 14px 14px 14px' — sol-üst, sağ-üst, sağ-alt, sol-alt). KENARLIK YÖN BAŞINADIR: her yön kendi CSS kısayolunu taşır ('1px solid var(--ng-border-primary)'), 'none' o kenarı kapatır; eski borderWidth/borderStyle/borderColor üçlüsü EMEKLİ (yalnız hiçbir yön yazılmamışsa okunur). shadow: çok katmanlı `box-shadow` metni ('0px 2px 5px 0px rgba(0,0,0,.2), inset 8px 5px 7px 0px #000'), tema token'ı ('var(--ng-shadow-md)') ya da eski preset anahtarı (none|sm|md|lg). DÖNDÜR/ÖLÇEKLE/KAYDIR (ADR 0005): dört alan TEK transform'a derlenir — sıra kaydır → döndür → ölçekle, köken merkez, düğüm çocuklarıyla döner; nötr değer (0°, 100, 0 px) hiçbir şey yazmaz. Değer BİRİMSİZ sayıdır ('15deg', '20px', '110%' yazılmaz) ve aralık dışı yazılmaz — mobilde ikisi de nativeStyle.warnings'e düşer. Transform'lu düğümün İÇİNDEKİ portal açmayan açılır menü/liste düğümün kutusuna hapsolur. hoverStyle.lift düğümün transform'unu ezmez, önüne eklenir. Katmanlar (modal, drawer, popover) ve uygulama kabukları (layout, layout-region, layout-shell, auth-layout, qm-content, qm-sidebar) bu dört alanı TAŞIMAZ: transform'lu ata position:fixed katmanı ekrandan koparır. Döndürmeyi serbest style.transform'a yazma — mobil yalnız tipli alanı çizer (MOB-002).",
|
|
36
36
|
typographyStyle: "{ textColor, fontFamily('var(--ng-font)' tema gövde | 'var(--ng-font-heading)' tema başlık | 'monospace' — token tema fontunu izler; serbest Google fontu yazma, tema yüklemez ve sessizce düşer), fontSize(CSS uzunluğu: '15px'|'1.1em'; çıplak sayı px sayılır), fontWeight(400|500|600|700), fontStyle(normal|italic), textDecoration(none|underline|line-through), lineHeight(TEK alan, üç yazım: oran '1.4' | yüzde '140%' | uzunluk '24px'; eski kayıtlardaki çıplak 140 yüzde sayılır), letterSpacing(CSS uzunluğu, negatif meşru: '-0.4px'), textAlign(left|center|right|justify) }. Komponentin içeriğine miras kalır.",
|
|
37
37
|
hoverStyle: "{ background, borderColor, shadow(none|sm|md|lg), lift(CSS uzunluğu: '2px'), transitionMs }. Hiçbir alan dolu değilse hover bloğu ve geçiş HİÇ yazılmaz.",
|
|
38
38
|
colorTokens: "RENK ALANLARI (background, textColor, borderColor, hover.background/borderColor) hex kadar tema token'ı da alır: 'var(--ng-accent-primary)', 'var(--ng-status-error)', 'var(--ng-background-inverse)'. Token yazılan alan tema değişince izler, hex yazılan kopar; tasarım sistemi renklerinde ÖNCE token'ı tercih et (studio panelinde aynı seçim tema chip'iyle yapılır).",
|
|
@@ -51,8 +51,6 @@ const NODE_SURFACE_NOTE = STYLE_GROUP_NOTES.surfaceStyle + ' ' + STYLE_GROUP_NOT
|
|
|
51
51
|
" 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.";
|
|
52
52
|
/** layout ve navigations'ın ORTAK menü satırı grubu (frontend style-group-schemas.ts navigationStyleGroup + navigation-style-logic.ts). */
|
|
53
53
|
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.";
|
|
54
|
-
/** Yerleşim grubunu taşıyan kapların ORTAK notu (container, box, box-section, aibox, form — ADR 0003, QA CT-001). */
|
|
55
|
-
const LAYOUT_ABSENT_NOTE = "EKSİK ANAHTAR VARSAYILAN DEĞİLDİR: layout prop'u hiç yazılmamışsa renderer IZGARA çizer, wrap hiç yazılmamışsa SARMAZ (flex-layout.ts, eski kayıtlar için). Şema varsayılanları (flex, wrap açık) yalnız Studio'da sürüklenip kurulan düğüme materyalize olur; page_schema_patch ile kurduğun kapta flex akış istiyorsan layout:'flex', sarma istiyorsan wrap:true'yu AÇIKÇA yaz. Studio paneli 2026-09-30'dan beri eksik anahtarı ekranla aynı gösterir (Grid / Wrap kapalı; designer.absent).";
|
|
56
54
|
export const componentKnowledge = {
|
|
57
55
|
html: {
|
|
58
56
|
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. KAPSAYICI DEĞİLDİR: içine komponent bırakılamaz, içeriği markup’ının kendisidir.',
|
|
@@ -132,7 +130,6 @@ export const componentKnowledge = {
|
|
|
132
130
|
form: {
|
|
133
131
|
summary: "Alanları saran kapsayıcı; gönderimde her alanın kendi kurallarını ve formun kendi form düzeyi kurallarını koşar, hepsi geçince submit yayar, hataları errorElementId'deki form-validation-errors listesinde toplar; toplu değeri (value) ve geçerliliği (isValid) çalışma zamanında kendi düğümüne yazar.",
|
|
134
132
|
behavior: [
|
|
135
|
-
LAYOUT_ABSENT_NOTE,
|
|
136
133
|
"GÖNDERİM: submit yalnız bütün kurallar geçince yayılır; kalırsa alanlar işaretlenir, liste dolar ve sayfa listeye kayar. Alan mesajları formun İLK gönderiminden sonra görünür, o andan itibaren her change o alanı canlı yeniden doğrular. Formu gönderen düğme Type='submit' olur (form içinde ya da formId ile bağlı); akışta event.source.id gönderen düğmenin ADI, event.source.props onun prop'larıdır — event.data boştur (componentEvents).",
|
|
137
134
|
"value ve isValid RUNTIME YAZAR, panelde çizilmez (2026-09-18): Page.components.<form>.value = { <alan adı>: değer } — yalnız doğrulama sözlüğündeki alan bileşenleri girer (text/button gibi gösterim düğümleri girmez), boş alan null, aralık seçici { valueFrom, valueTo }; gönderim akışında self.value ile de okunur ve uca olduğu gibi verilebilir. Page.components.<form>.isValid mount'ta ve her değişimde SESSİZCE yeniden hesaplanır (gizli alanlar muaf, form düzeyi kurallar dahil) — mesaj göstermez; submit düğmesini {{ !Page.components.<form>.isValid }} ile kilitlemenin yolu budur. İkisini setter ile YAZMA, sonraki değişimde ezilir.",
|
|
138
135
|
"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).",
|
|
@@ -155,46 +152,32 @@ export const componentKnowledge = {
|
|
|
155
152
|
box: {
|
|
156
153
|
summary: "Evrensel bırakma kutusu: container'dan farkı kutu modelinin border-box olması ve isteğe bağlı başlık/altlık bölgeleridir; yerleşim değer kümesi 2026-09-02'den beri container'ınkiyle aynıdır.",
|
|
157
154
|
behavior: [
|
|
158
|
-
LAYOUT_ABSENT_NOTE,
|
|
159
155
|
"layout iki değer alır: 'flex' (akış) ve 'grid' — ve 'grid' container'ınkiyle AYNI ŞEYDİR: mutlak koordinatlı 12 kolon canvas (kullanıcı kararı 2026-09-02, tek grid kavramı). Şemadaki eski 'cssgrid' değeri (akan GERÇEK display:grid) seçenek olmaktan çıktı: yeni yazımda geçmez (invalid-enum-value), yalnız o değerle KAYITLI eski düğümler çizilmeye devam eder (screen-builder/grid-layout.ts isCssGridLayout yalnız 'cssgrid'e bakar).",
|
|
160
156
|
"Yerleşim prop'ları bileşende OKUNMAZ: çocuk sarmalayıcısının stilini runtime'da RenderComponent, canvas'ta Draggable uygular (container ile aynı sözleşme).",
|
|
161
|
-
"GÖVDE İÇİN DÜĞÜM YOKTUR: kutunun kendi bırakma alanına inen her şey gövdedir. hasHeader/hasFooter ise ayrı 'box-section' DÜĞÜMLERİ açar
|
|
157
|
+
"GÖVDE İÇİN DÜĞÜM YOKTUR: kutunun kendi bırakma alanına inen her şey gövdedir. hasHeader/hasFooter ise ayrı 'box-section' DÜĞÜMLERİ açar; bölge kapatılınca içindeki çocuklar SİLİNMEZ, gövdeye taşınır — TEK İSTİSNA bölge açılınca tohumlanan varsayılan metindir: dokunulmadıysa bölgeyle birlikte silinir (ölçüldü 2026-09-18), düzenlendiyse o da taşınır.",
|
|
162
158
|
"KANVASTA BIRAKMA ALANI HİÇBİR DURUM PROP'UYLA ÖLMEZ (2026-09-18, CQ-308): isLoading gövdeyi gizler (opacity 0 + pointer-events none) ama yalnız çalışma anında/önizlemede — editörde (_editorMode) sadece yükleyici çizilir ve tasarımcı kutunun içine bileşen bırakmaya devam eder. Yükleyici akış DIŞINDA konumlandırılmış bir kaplamadır ve pointer-events:none ile tıklamayı geçirir; aksi hâlde kutunun üst şeridindeki bırakmayı yiyordu.",
|
|
163
|
-
"MOBİL TUZAĞI container ile aynıdır: flex çocukları telefonda ALT ALTA DÜŞMEZ (mobil kural yalnız ızgarayı yığar); satır yönündeki box 375px'te çocuklarını yan yana sıkıştırır. Telefonda yığılması gereken içerik için direction:'column' (box'ın varsayılanı) ya da layout:'grid' kullan. Sabit heightString mobilde ızgara kuralıyla sıfırlanır (qa-box-01 375 ölçümü: 200px → içerik boyu).",
|
|
164
159
|
"Kanvas toolbar'ında dört düğme vardır (2026-09-18): Has header · Has footer · Loading · Is hidden. Yerleşim kontrollerini kanvasın kendi kap toolbar'ı çizer, designer.toolbar'a hiçbir yerleşim prop'u girmez.",
|
|
165
160
|
"gridColumns/gridTemplate/gridRowGap ARTIK YALNIZ eski 'cssgrid' düğümlerinde okunur: o modda çocuğun blocks[].size.w'si 'grid-column: span N'e çevrilir ve gridTemplate doluysa gridColumns yok sayılır (şablon geçersizse kolon sayısına düşülür). layout:'grid' seçilen yeni kutuda bu üç prop ÖLÜDÜR — kolon payı yine blocks[].size.w'den gelir.",
|
|
166
161
|
"Yüzeyi TİPLİ GRUPLARDAN yönetilir: surfaceStyle (zemin, köşe, yön yön kenarlık, çok katmanlı gölge, gövde taşması), typographyStyle (içeriğe miras), hoverStyle ve box'a özgü sectionStyle (başlık/altlık bölgelerinin ayracı, ayraç rengi, bölge dolgusu). Bölgeler kutunun içinde bir eleman DEĞİL, gövdeye yerleşen ayrı 'box-section' düğümleridir; bu yüzden sectionStyle onları gerçek sınıflarından ('.ng-box-section--header/--footer') hedefler. style'ın tek parçası '&__body'dir — eski '&__header'/'&__footer' parçaları hiçbir elemana denk gelmediği için kaldırıldı."
|
|
167
162
|
],
|
|
168
163
|
propNotes: {
|
|
169
164
|
layout: "'flex' | 'grid' (2026-09-02'ye kadar ikinci değer 'cssgrid' idi). Diğer altı yerleşim prop'u yalnız 'flex' iken okunur; 'grid' container'ın mutlak 12 kolon canvas'ıdır ve çocuk ölçüsü blocks[].size'dan gelir.",
|
|
170
|
-
direction: "'row' | 'column'. Şema varsayılanı 'column' (kutunun sezgisi dikey yığın) AMA bu değer yalnız Studio'da sürüklenen düğüme yazılır; prop hiç yazılmamışsa SATIR çizilir (flex-layout.ts FLEX_ABSENT_PROPS, QA BX-001). page_schema_patch ile dikey yığın istiyorsan direction:'column'u AÇIKÇA yaz. Studio paneli ve kanvas araç çubuğu eksik yönü 2026-09-30'dan beri satır gösterir — ekranla aynı.",
|
|
171
|
-
hasHeader: "true → gateway kutunun İLK çocuğu olarak '<kutu>_header' elementId'li bir box-section düğümü ekler (ad alınmışsa _2, _3…). Başlık içeriğini add_component parent: '<kutu>_header' ile o düğüme koy; aynı çağrıda kutuyu ekleyen op'un ardından da hedeflenebilir. false → bölgenin çocukları gövdenin BAŞINA taşınır (silinmez), bölge düğümü kaldırılır.",
|
|
172
|
-
hasFooter: "true → '<kutu>_footer' box-section düğümü kutunun SON çocuğu olarak eklenir; içerik add_component parent: '<kutu>_footer'. false → çocuklar gövdenin SONUNA taşınır, bölge kaldırılır.",
|
|
173
|
-
horizontalAlign: "left | center | right | stretch. DİKKAT — box'ın varsayılan yönü SÜTUN olduğu için yatay hiza varsayılanda ÇAPRAZ eksendir (align-items), container'da (satır) ana eksendir. direction column + right: çocuklar sağa yaslanır (qa-box-01 bx_mid, x=951/1432). direction row iken ana eksen (justify-content); stretch ana eksende space-between, çaprazda tam doldurma. Yalnız layout flex iken okunur.",
|
|
174
|
-
verticalAlign: "top | middle | bottom | stretch. Box'ın varsayılan SÜTUN yönünde ANA eksendir (justify-content): middle çocukları dikeyde ortalar — ama kutunun yüksekliği içerikten geliyorsa dağıtacak boşluk yoktur, appearance.heightType fixed + heightString gerekir (bx_mid 200px'te çocuklar 38–154px). direction row iken çapraz eksen (align-items). Yalnız layout flex iken okunur.",
|
|
175
|
-
size: "'shrink' (çocuklar içerik/blok payı kadar) | 'grow' (flex: 1 1 auto, çocuklar kalan boşluğu paylaşır). Yazılmamışsa shrink. Yalnız layout flex iken okunur.",
|
|
176
|
-
gap: "none | small | medium (varsayılan) | large → 0 / var(--ng-spacing-sm) / --ng-spacing-md / --ng-spacing-lg (varsayılan temada 8/16/32px). allowCustom: '40px' gibi ham CSS de geçer (bx_gap ölçümü gap:40px). layout:'grid' (mutlak ızgara) iken ETKİSİZDİR ve panelde gizlenir; flex'te ve eski 'cssgrid' düğümlerinde etkilidir.",
|
|
177
|
-
wrap: "Satıra sığmayan çocuğu alt satıra atar. Varsayılan AÇIK ama yalnız Studio'da kurulan düğüme yazılır; prop hiç yazılmamışsa SARMAZ (nowrap) — page_schema_patch ile sarma istiyorsan wrap:true yaz. Kapalı satırda taşan çocuk gövdenin overflow:hidden'ı yüzünden KESİLİR (bx_nowrap: 4×400px, 4. çocuk görünmüyor). Sütun yönünde pratikte etkisizdir.",
|
|
178
|
-
isHidden: "Ortak katman görünürlüğü (RenderComponent okur): true iken kutu ve bütün çocukları DOM'a hiç girmez (bx_hidden ölçümü). Kanvas toolbar'ında tek tıkla açılır.",
|
|
179
165
|
gridTemplate: "Serbest grid-template-columns metni; beyaz listeden geçmeyen değer sessizce yok sayılır ve gridColumns geçerli olur. YALNIZ eski 'cssgrid' düğümlerinde etkilidir.",
|
|
180
|
-
gridColumns: "1–12; YALNIZ eski 'cssgrid' düğümlerinde okunur (eşit kolon sayısı) ve gridTemplate doluysa yok sayılır. layout 'flex' ya da 'grid' olan kutuda ÖLÜDÜR — kolon payı blocks[].size.w'den gelir.",
|
|
181
|
-
gridRowGap: "none | small | medium | large; YALNIZ eski cssgrid düğümlerinde satır aralığıdır. Yeni kutuda etkisizdir: flex akışta aralık gap prop'undan, ızgarada blokların konumundan gelir.",
|
|
182
166
|
surfaceStyle: STYLE_GROUP_NOTES.surfaceStyle + ' ' + STYLE_GROUP_NOTES.colorTokens + " EMEKLİ isBorder prop'unun yerini bu grup aldı (2026-08-31 tipli stil göçü): çerçeve artık yön başına borderTop/Right/Bottom/Left ile açılır, isBorder yazmak unknown-prop verir.",
|
|
183
167
|
typographyStyle: STYLE_GROUP_NOTES.typographyStyle + ' ' + STYLE_GROUP_NOTES.colorTokens,
|
|
184
168
|
hoverStyle: STYLE_GROUP_NOTES.hoverStyle,
|
|
185
|
-
sectionStyle: "{ headerDivider, footerDivider, dividerColor, sectionPadding(CSS uzunluğu: '12px') }. Ayraç anahtarı false ise bileşenin kendi ayracı KALDIRILIR (yok sayılmaz). dividerColor boş, yalnız boşluk ya da çözülmemiş ifade ise tema kenarlık token'ına düşer (2026-09-18); eskiden boşluk değeri çizgiyi METİN rengiyle (currentColor) çizdiriyor, çözülmemiş ifade ise bildirimi düşürüp bölgenin taban çizgisine bırakıyordu — ayraç kaybolmuyor, yanlış renkte çiziliyordu.
|
|
186
|
-
isLoading: "Yükleniyor durumu: gövde gizlenir
|
|
169
|
+
sectionStyle: "{ headerDivider, footerDivider, dividerColor, sectionPadding(CSS uzunluğu: '12px') }. Ayraç anahtarı false ise bileşenin kendi ayracı KALDIRILIR (yok sayılmaz). dividerColor boş, yalnız boşluk ya da çözülmemiş ifade ise tema kenarlık token'ına düşer (2026-09-18); eskiden boşluk değeri çizgiyi METİN rengiyle (currentColor) çizdiriyor, çözülmemiş ifade ise bildirimi düşürüp bölgenin taban çizgisine bırakıyordu — ayraç kaybolmuyor, yanlış renkte çiziliyordu.",
|
|
170
|
+
isLoading: "Yükleniyor durumu: gövde gizlenir ve yerine Loader çizilir — ama YALNIZ çalışma anında/önizlemede. Editör kipinde (_editorMode) gövde dokunulmaz kalır, yalnız yükleyici kaplaması eklenir; kanvasta kutunun içine bırakmak çalışmaya devam eder (CQ-308).",
|
|
187
171
|
style: STYLE_GROUP_NOTES.styleEscape + " Tek parça '&__body'dir; eski '&__header'/'&__footer' parçaları şemadan KALDIRILDI çünkü bölgeler kutunun markup'ında eleman değil ayrı box-section düğümleridir (eski CQ-157). Bölge görünümü sectionStyle'ın işidir."
|
|
188
172
|
}
|
|
189
173
|
},
|
|
190
174
|
'box-section': {
|
|
191
|
-
summary: "box'ın başlık/altlık bölgesi. AI BU DÜĞÜMÜ DOĞRUDAN
|
|
175
|
+
summary: "box'ın başlık/altlık bölgesi. AI BU DÜĞÜMÜ DOĞRUDAN KULLANMAZ: şemaya elle eklenmez, yalnız box'ın hasHeader/hasFooter anahtarları onu açar ve kapatır (slot/view emsali).",
|
|
192
176
|
behavior: [
|
|
193
|
-
LAYOUT_ABSENT_NOTE,
|
|
194
177
|
'Yüzeysiz sarmalayıcıdır: kendi zemini/kenarlığı yoktur, yalnız bölge ayracını çizer (header altına, footer üstüne).',
|
|
195
178
|
"Palette GÖRÜNMEZ (isHide) ve SİLİNEMEZ (isDeletable:false) — kaldırmanın tek yolu box'ın ilgili anahtarını kapatmaktır.",
|
|
196
179
|
"isLoading prop'u YOKTUR: yükleniyor durumu kutunun kendisindedir, bölge onu hiç görmez — dolayısıyla CQ-308'in bırakma alanını öldüren kalıbı bu düğümde hiç oluşmaz.",
|
|
197
|
-
"Kendi yerleşimini panelden değil ELEMENT AĞACINDAN seçilerek düzenler (palette gizli, ağaçta görünür); gap alanı hâlâ eski gap+gapCustom ikilisini taşır (box'ta tek
|
|
180
|
+
"Kendi yerleşimini panelden değil ELEMENT AĞACINDAN seçilerek düzenler (palette gizli, ağaçta görünür); gap alanı hâlâ eski gap+gapCustom ikilisini taşır (box'ta tek preset alanına indi; liste dışı değer platformda 422).",
|
|
198
181
|
"role prop'u ('header' | 'footer') bölgenin kimliğidir ve gizlidir; elle değiştirmek yerleşimi bozar.",
|
|
199
182
|
"Ayraç rengi ve bölge dolgusu artık kutunun 'sectionStyle' grubundan yönetilir (bölge düğümünün kendi şemasından değil): headerDivider/footerDivider/dividerColor/sectionPadding."
|
|
200
183
|
],
|
|
@@ -211,12 +194,11 @@ export const componentKnowledge = {
|
|
|
211
194
|
"Kanvas toolbar'ı: direction · variant · thickness · color · isHidden."
|
|
212
195
|
],
|
|
213
196
|
propNotes: {
|
|
214
|
-
label: 'Çizginin ortasındaki metin; yalnız yatayda çizilir. Sayı gelirse metne çevrilir.
|
|
197
|
+
label: 'Çizginin ortasındaki metin; yalnız yatayda çizilir. Sayı gelirse metne çevrilir.',
|
|
215
198
|
direction: "'horizontal' (varsayılan) | 'vertical'. Dikey çizginin kendi genişliği yoktur, hücresinde ortalanır.",
|
|
216
|
-
isHidden: "Ortak katman görünürlüğü: true iken ayraç DOM'a hiç girmez, yer de tutmaz (dv_hidden ölçümü, 2026-10-01). Kanvas toolbar'ından tek tıkla açılır.",
|
|
217
199
|
variant: "'solid' | 'dashed' | 'dotted'.",
|
|
218
200
|
thickness: 'Çizgi kalınlığı px; en az 1. Kesikli/noktalı desende parça boyu da bununla büyür.',
|
|
219
|
-
color: "Beş semantik değer + 'custom' (customColor ile); boş bırakılırsa tema kenarlık rengi (--ng-border-primary). 'custom' seçilip customColor geçersiz/boşsa 'primary' tonuna düşer, kenarlık rengine DEĞİL.
|
|
201
|
+
color: "Beş semantik değer + 'custom' (customColor ile); boş bırakılırsa tema kenarlık rengi (--ng-border-primary). 'custom' seçilip customColor geçersiz/boşsa 'primary' tonuna düşer, kenarlık rengine DEĞİL.",
|
|
220
202
|
customColor: "Yalnız color 'custom' iken okunur; hex/rgb/hsl/adlandırılmış renk ya da tema token'ı. Hex/rgb tema değişimini izlemez, var(--ng-…) token'ı izler.",
|
|
221
203
|
style: 'Köke uygulanır; şemada parça seçicisi yok. Çizgi ve etiket kökteki CSS değişkenlerinden boyanır (--divider-color/--divider-width/--divider-style); style içinde bu değişkenler yazılırsa inline değeri EZER (designerCss !important), iç parçalara "& .ng-divider__line" / "& .ng-divider__label" ile ulaşılır.'
|
|
222
204
|
}
|
|
@@ -224,7 +206,7 @@ export const componentKnowledge = {
|
|
|
224
206
|
spacer: {
|
|
225
207
|
summary: 'Boşluk bileşeni: sabit yükseklik (size px) ya da esnek itici. Çalışma anında GÖRÜNMEZ; yalnız editörde taralı çizilir. Olay YAYMAZ, içine bileşen bırakılmaz.',
|
|
226
208
|
behavior: [
|
|
227
|
-
"mode 'fixed' iken size kadar px YÜKSEKLİK kaplar, genişliği hep %100'dür.
|
|
209
|
+
"mode 'fixed' iken size kadar px YÜKSEKLİK kaplar, genişliği hep %100'dür. Satır (row) kapta yatay boşluk isteniyorsa ölçü size'dan değil düğümün genişliğinden gelir: appearance.widthType 'fixed' + widthString ('24px').",
|
|
228
210
|
"mode 'flex' iken düğüm flex kabın ANA ekseninde kalan alanı alır ve kardeşlerini uçlara iter (sütunda dikey, satırda yatay; wrap açıkken de aynı satırda kalır). 2026-09-18'den önce çalışma anında 0px'ti. Kabın ölçüsü ana eksende belirli olmalı — auto/hug yükseklikli bir sütunda kalan alan yoktur, spacer 0px kalır. Kabın kendi size prop'u 'grow' ise kardeşler de büyür ve kalan alan paylaşılır; itici etkisi için kap 'shrink' kalmalı.",
|
|
229
211
|
"12 kolonlu grid kapta hücre ölçer (blocks[].size.h × satır yüksekliği): 'fixed' size kadar çizilir, hücreden büyükse satırlar uzar; 'flex' kipi düğümün yüksekliği sabitlenmedikçe (appearance.heightType 'fixed'/'fill') 0px'tir, sabitlenince hücreyi doldurur ama kimseyi itmez. Spacer'ın yeri flex kaptır.",
|
|
230
212
|
'showInEditor kapatılırsa editörde de görünmez — sayfayı okurken boşluğun neden orada olduğu anlaşılmaz, açık bırakmak yeğdir (Element Tree tek seçme yolu kalır).',
|
|
@@ -232,10 +214,8 @@ export const componentKnowledge = {
|
|
|
232
214
|
],
|
|
233
215
|
propNotes: {
|
|
234
216
|
mode: "'fixed' (size px yükseklik) | 'flex' (ana eksende kalanı doldurur, itici). 'flex' ortak katman sözleşmesidir: düğüm sarmalayıcısı flex 1 1 0 alır, appearance genişlik/yükseklik kipinden bağımsız.",
|
|
235
|
-
size: "Yalnız 'fixed' kipte okunur; px, min 0.
|
|
236
|
-
showInEditor: 'Editördeki taralı iz; runtime her zaman görünmez.
|
|
237
|
-
isHidden: "Ortak katman görünürlüğü: true iken düğüm DOM'a hiç girmez, yani boşluk da (dış boşluğun 8px'i dâhil) kalkar (sp_hidden ölçümü, 2026-10-01). Kanvasta gizli spacer taralı iziyle çizilmeye devam eder.",
|
|
238
|
-
style: "Köke uygulanır (tek <div>, parça seçicisi yok). Spacer yayında saydamdır; style ile background/border verilirse yayında da görünür olur — background: kırmızı ölçümde 32px'lik dolu bir şerit çizdi ve kanvastaki taramayı örttü. Boşluk ölçüsü için style değil size (sabit kip) ya da düğüm genişliği kullanılır."
|
|
217
|
+
size: "Yalnız 'fixed' kipte okunur; px, min 0. Yatay boşluk için düğüm genişliği (appearance.widthString) kullanılır, size değil.",
|
|
218
|
+
showInEditor: 'Editördeki taralı iz; runtime her zaman görünmez.'
|
|
239
219
|
}
|
|
240
220
|
},
|
|
241
221
|
popover: {
|
|
@@ -319,9 +299,8 @@ export const componentKnowledge = {
|
|
|
319
299
|
}
|
|
320
300
|
},
|
|
321
301
|
aibox: {
|
|
322
|
-
summary: "
|
|
302
|
+
summary: "box'ın akış/bölge işlevini taşıyan kutu; farkı STİL YÖNETİMİNDE: yüzey, tipografi, hover ve bölge görünümü tipli prop gruplarıdır (surfaceStyle · typographyStyle · hoverStyle · sectionStyle), ham CSS değil.",
|
|
323
303
|
behavior: [
|
|
324
|
-
LAYOUT_ABSENT_NOTE,
|
|
325
304
|
"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).",
|
|
326
305
|
"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.",
|
|
327
306
|
"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.",
|
|
@@ -334,9 +313,8 @@ export const componentKnowledge = {
|
|
|
334
313
|
surfaceStyle: STYLE_GROUP_NOTES.surfaceStyle + ' ' + STYLE_GROUP_NOTES.colorTokens,
|
|
335
314
|
typographyStyle: STYLE_GROUP_NOTES.typographyStyle + ' ' + STYLE_GROUP_NOTES.colorTokens,
|
|
336
315
|
hoverStyle: STYLE_GROUP_NOTES.hoverStyle,
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
sectionStyle: "{ headerDivider, footerDivider, dividerColor, sectionPadding(CSS uzunluğu: '12px') }. Ayraç anahtarı false ise bileşenin kendi ayracı KALDIRILIR (yok sayılmaz). Anahtarlar varsayılan açıktır: yalnız dividerColor yazmak iki ayracı o renkle çizer (QA BX-005, box ile aynı derleyici).",
|
|
316
|
+
gapCustom: 'Sayısal px boşluğu (0-200); doluysa gap preset\'ini EZER. Eski kanal. Preset listesi dışında bir boşluk gerekiyorsa tek yol budur: gap alanı yalnız none | small | medium | large kabul eder, \'18px\' gibi ham değer platform doğrulamasında invalid-enum-value ile reddedilir.',
|
|
317
|
+
sectionStyle: "{ headerDivider, footerDivider, dividerColor, sectionPadding(CSS uzunluğu: '12px') }. Ayraç anahtarı false ise bileşenin kendi ayracı KALDIRILIR (yok sayılmaz).",
|
|
340
318
|
style: STYLE_GROUP_NOTES.styleEscape + " Parça olarak yalnız '&__body' bildirilmiştir çünkü markup'ta gerçekten o eleman vardır."
|
|
341
319
|
}
|
|
342
320
|
},
|
|
@@ -348,15 +326,14 @@ export const componentKnowledge = {
|
|
|
348
326
|
"BAŞLIK BANDI title YA DA description doluyken çizilir (2026-09-18): description başlığın altındaki ikinci satırdır (ikincil metin rengi, küçük punto) ve yalnız açıklama yazmak da bandı açar. İki alan da KIRPILIR: yalnız boşluktan ibaret bir başlık/açıklama doldurulmamış sayılır ve bant açılmaz. states.isWrapper:true iken ikisi de çizilmez.",
|
|
349
327
|
"KANVASTA BIRAKMA ALANI HİÇBİR DURUM PROP'UYLA ÖLMEZ (2026-09-18): isLoading gövdeyi 100px'e kırpar ve slot'u pointer-events:none yapar ama yalnız çalışma anında/önizlemede — editörde (_editorMode) sadece yükleyici çizilir, tasarımcı kabın içine bileşen bırakmaya devam eder. Yükleyici akış DIŞINDA, konumlandırılmış bir kaplamadır ve tıklamayı geçirir: akış içinde çizildiğinde bırakma alanını görünür kutunun altına itiyordu. Kanvas toolbar'ında iki düğme vardır (Loading, Is hidden); yerleşim kontrollerini kanvasın kendi kap toolbar'ı çizer.",
|
|
350
328
|
"page_container'ın isLoading prop'u sayfa açılış akışının yükleniyor bayrağıdır.",
|
|
351
|
-
"GÖVDE TAŞMASI yüksekliğe bağlıdır (2026-09-29): appearance.heightType:'auto' olan (ve isScrollable olmayan) kabın gövdesi KAYDIRMA KABI DEĞİLDİR — overflow-y:visible + overflow-x:clip. İçerik kadar boylanan kap zaten kaymaz; eskiden 1px'lik yuvarlama ya da taşan bir glif gövdede kaydırma okları çiziyordu (Rexora dashboard: profit_summary 45/46). fixed/fill/yazılmamış yükseklikte gövde eskisi gibi overflow-y:auto'dur — dolduran bir kök (yerleşim kabuğu) sayfayı bu gövdede kaydırır ve isSticky başlık ona yapışır. surfaceStyle.contentOverflow seçimi her iki durumda da KAZANIR.",
|
|
352
329
|
"layout:'flex' çocukları akışa alır (RenderComponent düzeni .ng-app__node-children sarmalına yazar): sıra blocks[].position'dan gelir (önce y, sonra x) ama y BOŞLUKLARI yok sayılır — flex'te dikey konum yalnız sıradır, ızgara koordinatı değil.",
|
|
353
330
|
"Flex çocuğun GENİŞLİĞİ appearance.widthType'tan gelir (2026-09-01): 'fill' kabın tüm genişliği (satırda flex:1 1 100%), 'fixed' + widthString sabit CSS ölçüsü ('240px'/'50%'/calc), 'auto' içerik kadar. widthType HİÇ yazılmamışsa eski 12 kolonluk blocks[].size.w payı geçerlidir (row'da flex-basis w/12, column'da width w/12) — ızgara↔flex geçişi bu fallback sayesinde kayıpsızdır. Şemayı sen kuruyorsan widthType'ı AÇIKÇA yaz; string yalnız 'fixed' modda okunur (PAGE-017/018 uyarıları).",
|
|
354
331
|
"Flex kapsayıcının yüksekliği içeriğinden gelir; verticalAlign'ın dağıtacak boşluğu olması için appearance.heightType:'fixed' vermek gerekir — ölçü heightString'den (serbest CSS uzunluğu, ör. '30vh'), o yoksa size.h×10px'ten. heightString yalnız heightType:'fixed' iken okunur. İstisna: states.isWrapper:true olan page_container zaten min-height:80vh ile sayfa boyu durur, onda dikey hizalama boşluksuz da çalışır.",
|
|
355
332
|
"ÜÇÜNCÜ YÜKSEKLİK: appearance.heightType:'fill' (2026-08-28) — yükseklik ne içerikten ne satır sayısından gelir, EBEVEYNİN BIRAKTIĞI yerden gelir: ızgara çocuğunda height:100% + align-self:stretch, flex sütununda flex:1 1 auto + min-height:0, flex satırında align-self:stretch + height:100%. Kaydırılabilir bir fill düğümü büyümek yerine içinde kaydırır. KÖK düğümde ekranı doldurur (100vh) — yerleşim kabuğu bununla kurulur.",
|
|
356
333
|
"layout:'grid' iken diğer altı prop okunmaz — Studio panelinde de gizlenir. Katalogda tanımlı oldukları için doğrulama duvarı susar: ızgara kapsayıcıya direction yazmak sessizce hiçbir şey yapmaz (gateway PAGE-015 ile uyarır).",
|
|
357
334
|
"Katalog varsayılanı 2026-08-25'te grid → FLEX oldu ama varsayılan düğüm KURULURKEN props'a yazılır (Studio bırakma yolu definition.defaults'u kopyalar), renderer'da geriye dönük bir etkisi YOKTUR: layout prop'u hiç olmayan düğüm — bütün eski kayıtlar — ızgara çizilmeye devam eder. Yani şemayı sen kuruyorsan varsayılana güvenme, layout'u açıkça yaz.",
|
|
358
|
-
"YERLEŞİM (layout) KURARKEN DE TERCİH EDİLEN KAPTIR: layout views'ü sıradan bir komponent ağacıdır ve kökü container'dır — Studio'nun
|
|
359
|
-
"
|
|
335
|
+
"YERLEŞİM (layout) KURARKEN DE TERCİH EDİLEN KAPTIR: layout views'ü sıradan bir komponent ağacıdır ve kökü container'dır — Studio'nun yeni layout iskeleti (getDefaultLayout) tam olarak bunu kurar: states.isWrapper:true + appearance.heightType:'fill' + block x0/w12 kök (sayfanın page_container'ının yerleşim ikizi: çerçevesiz, başlıksız, ekranı dolduran), içinde yan menü kabı (w2, fill) + içerik sütunu (w10, fill, direction:'column') → üst şerit + slot (fill). layout-shell/layout-region ikilisi emekliye ayrıldı (platform_guide('layout')).",
|
|
336
|
+
"DAR EKRAN TUZAĞI — flex çocukları telefon genişliğinde ALT ALTA DÜŞMEZ: runtime'ın dar ekran kuralı yalnız ızgara özelliklerini ezer (RenderComponent.svelte, @media max-width:767px → grid-row/grid-column/height), flex çocuğu genişliğini getFlexChildStyle'ın flex-basis'inden alır ve flex-wrap:nowrap altında satır bozulmaz. 375px'te ölçüldü: aynı span'lerle ızgara kabın çocukları 375/375px alt alta, flex kabınkiler 49/310px yan yana. Telefonda yığılması gereken satır için layout:'grid' kullan; wrap artık varsayılan açık (2026-09-01) ama sarma yalnız sığmayan çocuğu alta atar, ızgara yığılmasının yerini tutmaz (zeyrek-frontend docs/issues.md ARC-031)."
|
|
360
337
|
],
|
|
361
338
|
propNotes: {
|
|
362
339
|
surfaceStyle: STYLE_GROUP_NOTES.surfaceStyle + ' ' + STYLE_GROUP_NOTES.colorTokens + " Kapsayıcının TABANI tema token'larıdır (--ng-background-surface zemin, 1px --ng-border-primary çerçeve, --ng-rounded köşe); alan boş bırakılırsa tema izlenir. contentOverflow gövdeye ('&__body') yazılır.",
|
|
@@ -368,14 +345,11 @@ export const componentKnowledge = {
|
|
|
368
345
|
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.",
|
|
369
346
|
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.",
|
|
370
347
|
size: "'shrink' (çocuklar flex: 0 1 auto, varsayılan) | 'grow' (flex: 1 1 auto — çocuklar boşluğu paylaşır).",
|
|
371
|
-
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).
|
|
372
|
-
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.
|
|
348
|
+
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). Yalnız bu dört preset geçer: '18px' ya da 'var(--ng-spacing-xl)' gibi ham değer platform doğrulamasında invalid-enum-value ile reddedilir. Çocuk genişlik formülünden payı düşülür, böylece w toplamı 12 olan satır tam kapanır.",
|
|
349
|
+
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.",
|
|
373
350
|
title: "Varsayılanı boştur. isWrapper:false kapta yalnız açıkça doluysa başlık çizer; page_container'da ise dolu değer tarayıcı sekmesinin adını yazar (browserTitle).",
|
|
374
351
|
description: "Başlığın ALTINDAKİ ikinci satır (2026-09-18): ikincil metin renginde, başlıktan küçük punto. Varsayılanı boştur ve boşken eleman hiç çizilmez, bandın yüksekliğini değiştirmez. Yalnız description yazmak başlık bandını açar (title boş kalabilir); sarmalayıcı kipte (page_container, yerleşim kökü) title gibi o da çizilmez. Kart başlığının altına açıklama yazmak için artık içine text bileşeni bırakmak gerekmez.",
|
|
375
|
-
isLoading: "Gövdeyi 100px'e kısar, slot'u gizler ve spinner gösterir — ama YALNIZ çalışma anında ve önizlemede. Kanvasta (editör kipi) gövde kırpılmaz, yalnız yükleyici çizilir ve bırakma alanı çalışmaya devam eder (2026-09-18). page_container'da sayfa açılış akışının yükleniyor bayrağıdır; kanvas toolbar'ından tek tıkla açılır.
|
|
376
|
-
isHidden: "Ortak katman görünürlüğü (RenderComponent okur): true iken düğüm ve bütün çocukları hiç çizilmez. Kanvas toolbar'ında tek tıkla açılır.",
|
|
377
|
-
style: STYLE_GROUP_NOTES.styleEscape +
|
|
378
|
-
" Container parçaları: '&__body' (gövde — çocukların dolgusu/kaydırması buraya), '&__header' (başlık bandı), '&__title' (başlık metni). Başlık rengi/puntosu/ayraç/bant dolgusu için önce headerStyle."
|
|
352
|
+
isLoading: "Gövdeyi 100px'e kısar, slot'u gizler ve spinner gösterir — ama YALNIZ çalışma anında ve önizlemede. Kanvasta (editör kipi) gövde kırpılmaz, yalnız yükleyici çizilir ve bırakma alanı çalışmaya devam eder (2026-09-18). page_container'da sayfa açılış akışının yükleniyor bayrağıdır; kanvas toolbar'ından tek tıkla açılır."
|
|
379
353
|
}
|
|
380
354
|
},
|
|
381
355
|
repeater: {
|
|
@@ -599,7 +573,7 @@ export const componentKnowledge = {
|
|
|
599
573
|
'Bir tık İKİ olay yayar: önce change, sonra yeni duruma göre checked ya da unchecked. Üçü de setter’dır (self.value yazılır) — kaydı yalnız BİRİNE bağla, yoksa akış iki kez koşar. checked/unchecked yalnız "işaretlenince şunu yap" gibi tek yönlü işler için vardır.',
|
|
600
574
|
'Kilitli (isDisabled/isReadonly/isViewmode) ya da isLoading olan kutu hiçbir olay yaymaz; focus/blur de susar.',
|
|
601
575
|
'value akıştan METİN gelirse: "false" · "0" · "no" · "off" · "null" · "undefined" · "nan" · boş metin YANLIŞ sayılır, kalan dolu metin doğru. Yine de alana boolean yaz — sözleşme boolean’dır.',
|
|
602
|
-
'Zorunluluk prop değil, Form’un doğrulama listesinden gelir (`required`). checkbox’ın TEK doğrulama kuralı odur — panel boolean tipinin listesini çizer, desen/uzunluk kuralı yoktur.',
|
|
576
|
+
'Zorunluluk prop değil, Form’un doğrulama listesinden gelir (`required`). checkbox’ın TEK doğrulama kuralı odur — panel boolean tipinin listesini çizer, desen/uzunluk kuralı yoktur. `required` "İŞARETLİ OLMALI" demektir: işaretsiz kutu (false) formu geçirmez, "koşulları kabul et" için form düzeyinde ayrı koşul yazma.',
|
|
603
577
|
'Birden çok seçenek gerekiyorsa checkbox yığmak yerine checkboxgroup kullan: değeri string[] ve seç-tümü/sayaç onda hazır.'
|
|
604
578
|
],
|
|
605
579
|
propNotes: {
|
|
@@ -798,7 +772,7 @@ export const componentKnowledge = {
|
|
|
798
772
|
value: "Seçili dosya(lar). Panelde ÇİZİLİR ve akıştan yazılabilir (2026-09-17'ye kadar gizliydi, bu yüzden AI sözlüğünde de görünmüyordu): kayıtlı bir dosyayı forma geri basmanın yolu budur. Tekli kipte nesne, çoklu kipte dizi; boşaltmak için null (çoklu kipte []). Kipiyle uyuşmayan şekil de OKUNUR: çoklu kipte yazılan tek nesne listelenir, tekli kipte yazılan dizinin ilk dosyası çizilir (2026-09-17'ye kadar ikisi de sessizce hiçbir şey göstermiyordu). İçeriği olmayan kayıt (ne value ne data ne absolute_path) hiç çizilmez.",
|
|
799
773
|
text: 'Butonun üzerindeki metin (varsayılan "Attach File"); ikon sabittir. Alanın başlığı ayrı bir prop\'tur: label.',
|
|
800
774
|
description: 'Butonun altındaki yardım metni. Dosya seçilir seçilmez yerini dosya listesi alır, seçim temizlenince geri gelir (fileInput ile aynı kural).',
|
|
801
|
-
allowedFiletypes: 'İzin verilen uzantılar (çoklu seçim, kapalı liste). Hem dosya diyaloğunun accept süzgecini hem de seçimden SONRAKİ denetimi besler: liste dışı bir dosya seçilirse değere girmez ve komponentin içinde "desteklenmiyor" uyarısı çizilir (2026-09-17; öncesinde yalnız diyalog süzgeciydi, "Tüm dosyalar" ile aşılabiliyordu). Hem allowedFiletypes hem customFiletypes boşsa her tür serbesttir.',
|
|
775
|
+
allowedFiletypes: 'İzin verilen uzantılar (çoklu seçim, kapalı liste). Hem dosya diyaloğunun accept süzgecini hem de seçimden SONRAKİ denetimi besler: liste dışı bir dosya seçilirse değere girmez ve komponentin içinde "desteklenmiyor" uyarısı çizilir (2026-09-17; öncesinde yalnız diyalog süzgeciydi, "Tüm dosyalar" ile aşılabiliyordu). Hem allowedFiletypes hem customFiletypes boşsa her tür serbesttir. Akış prop\'a düz metin yazabilir ("pdf,png", customFiletypes ile aynı ayraçlar) — 2026-09-25`e kadar bu komponenti `input.map is not a function` ile düşürüyordu (fileInput okuyordu).',
|
|
802
776
|
customFiletypes: 'Listede olmayan uzantılar, serbest metin ("heic, dwg;psd"). Virgül, noktalı virgül ve boşluk ayraçtır; baştaki nokta ve yıldız atılır, büyük/küçük harf fark etmez. allowedFiletypes ile BİRLEŞİR, onun yerine geçmez (fileInput ile aynı ad ve aynı kural). Çok parçalı uzantı da yazılabilir ("tar.gz"): eşleşme adın SONUNA bakar, son noktadan sonrasına değil.',
|
|
803
777
|
maxFileSizeMb: 'Dosya BAŞINA en büyük boyut (MB). Boş/0/negatif değer sınırsız demektir; aşan dosya değere girmez, uyarı komponentin içinde çizilir.',
|
|
804
778
|
maxFileCount: "Çoklu kipte toplam dosya sayısı sınırı — zaten seçili olanlar da sayılır. Boş/0/negatif sınırsız. Tekli kipte hiç okunmaz ve panelde de gizlidir (isMultiple'a bağlı).",
|
|
@@ -832,8 +806,6 @@ export const componentKnowledge = {
|
|
|
832
806
|
"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.",
|
|
833
807
|
"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.",
|
|
834
808
|
"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).",
|
|
835
|
-
"YATAY DOLGU ikon + metinde MÜREKKEBE göre dengelenir (2026-09-29): Material glifinin ~0.2em yan boşluğu yüzünden eşit kutu dolgusunda ikon tarafı 3px geniş görünüyordu ('Save Order': glif 16px, metin 13px). Bileşen ikon tarafını o kadar daraltır (ikon sağdaysa sağı). Dolguyu büyütmek/küçültmek için style.padding YAZMA — !important ile dengeyi ezer; style: { '--ng-btn-pad-x': '18px' } yaz, iki taraf ondan türetilir. Pill (radius-pill) düğmede 16-18px, lg'nin 12px tabanı dar görünür.",
|
|
836
|
-
"METİN RENGİ zeminin ölçülen parlaklığından seçilir (2026-09-29, shared/utils getContrastTextColor): açık zemine koyu, koyu zemine açık metin; temanın onPrimary'si (--ng-text-on-accent) o polaritedeyse o kullanılır, değilse #000000/#ffffff. Tema metin token'ı (--ng-text-primary) YEDEK DEĞİLDİR: koyu modda açığa döner ve açık accent'li butonda (Rexora #B8F06C) metni okunmaz yapıyordu. Tema modu değişince (theme-toggle) renk yeniden hesaplanır; aynı kural icon çipinde ve tablo etiketlerinde de geçerlidir.",
|
|
837
809
|
"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).",
|
|
838
810
|
"İ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)."
|
|
839
811
|
],
|
|
@@ -918,8 +890,6 @@ export const componentKnowledge = {
|
|
|
918
890
|
"image boşsa bant HİÇ çizilmez (kart başlık/açıklama/butona çöker); adres çözülemezse bandın yerine kırık görsel kutusu gelir.",
|
|
919
891
|
"buttonClick kabarcığı DURDURMAZ: butona basınca önce buttonClick, sonra kartın click olayı yayılır. Yalnız buton eylemi isteniyorsa kartın click bağını boş bırakın.",
|
|
920
892
|
"isLoading açıkken içerik yerine iskelet çizilir ve hiçbir tıklama olayı yayılmaz.",
|
|
921
|
-
"İÇERİK PROP'LARI YAZILMAZSA KART BOŞ ÇİZİLİR: title/description/buttonText/image'in varsayılanları ('Card Title', yer tutucu görsel) yalnız Studio'da sürüklenip bırakılan karta yazılan ÖRNEK içeriktir. page_schema_patch ile kurduğun kartta göstermek istediğin her parçayı AÇIKÇA yaz; yazmadığın parça hiç çizilmez (qa-card-01 cd_absent: yalnız çerçeve). Studio paneli de 2026-09-30'dan beri eksik anahtarı BOŞ gösterir (designer.absent, QA CD-003).",
|
|
922
|
-
"KLAVYE (2026-09-30, QA CD-005): butonlu kartta klavye kullanıcısı BUTONA ulaşır — butona basmak buttonClick ve ardından click yayar, kartın kökü ayrıca odaklanmaz. Butonsuz kartta (buttonText boş) kök kendisi düğmedir: role=button, Tab ile odaklanır, Enter/Space click yayar, imleç el olur. Kart click'in bağlı olup olmadığını bilmez; bu yüzden click'i bağlanmamış butonsuz kart da bir odak durağıdır — tıklanması anlamsız kartta buttonText'i boş bırakıp click'siz kullanmak yerine içeriği text/image ile kur.",
|
|
923
893
|
'Yükseklik 10-50 aralığındadır (min 10, varsayılan 32, max 50). Varsayılan 32, kartın kendi içeriğinin (160px bant + başlık/açıklama + buton) taşmadan sığdığı en küçük boydur; daha kısaya çekilirse bant sıkışır. 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.'
|
|
924
894
|
],
|
|
925
895
|
propNotes: {
|
|
@@ -928,12 +898,7 @@ export const componentKnowledge = {
|
|
|
928
898
|
imageWidth: 'Görselin bant İÇİNDEKİ genişliği (px). Yazılmazsa bandın tamamı; dar yazılırsa görsel bantta ortalanır.',
|
|
929
899
|
imageFit: "cover|contain|fill|none — CSS object-fit. Temizlenirse 'cover'.",
|
|
930
900
|
isLoading: 'Akışın ya da tasarımcının açtığı iskelet: içerik yerine parlayan kutular çizilir, click/buttonClick yayılmaz.',
|
|
931
|
-
title:
|
|
932
|
-
description: 'Başlığın altındaki metin. En çok 4 satır çizilir, fazlası üç noktayla kesilir (tamamı ipucunda); yer darsa önce görsel bandı küçülür, metin kesilmez (QA CD-001, 2026-09-30). Yazılmazsa çizilmez.',
|
|
933
|
-
buttonText: "Kartın alt kısmındaki butonun etiketi; tek satır, sığmazsa üç nokta. BOŞ ya da yazılmamışsa buton HİÇ çizilmez (buton şeridi de yok) — buttonClick'i ancak dolu etiketli kartta bağla.",
|
|
934
|
-
isHidden: 'Ortak katman görünürlüğü: true iken kart DOM’a girmez.',
|
|
935
|
-
style: STYLE_GROUP_NOTES.styleEscape +
|
|
936
|
-
" Card'ın tipli stil grubu YOKTUR; görünüm yalnız bu alandan verilir. Parçalar: '&__image' (görsel bandı), '&__title', '&__description', '&__button'. Kökün kenarlığı/zemini için düğüm kutusu (appearance) ya da parçasız anahtarlar."
|
|
901
|
+
title: 'Kart başlığı; aynı zamanda görselin alt metnidir (ayrı bir alt prop yoktur).'
|
|
937
902
|
}
|
|
938
903
|
},
|
|
939
904
|
'qm-card': { summary: 'QM gösterge kartı; click yayar.' },
|
|
@@ -949,14 +914,12 @@ export const componentKnowledge = {
|
|
|
949
914
|
"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."
|
|
950
915
|
],
|
|
951
916
|
propNotes: {
|
|
952
|
-
surfaceStyle:
|
|
953
|
-
tabs: "[{ key, text, icon, isDisabled, isHidden, keepAlways }] — key sekmenin kimliğidir, benzersiz olmalı; boş bırakılırsa sekmenin SIRASI (\"0\", \"1\"…) kimlik sayılır. Studio key'i text'ten snake_case üretir.
|
|
917
|
+
surfaceStyle: NODE_SURFACE_NOTE,
|
|
918
|
+
tabs: "[{ key, text, icon, isDisabled, isHidden, keepAlways }] — key sekmenin kimliğidir, benzersiz olmalı; boş bırakılırsa sekmenin SIRASI (\"0\", \"1\"…) kimlik sayılır. Studio key'i text'ten snake_case üretir.",
|
|
954
919
|
selected: "Açık sekmenin key'i; setter ile yazılırsa sekme değişir (olay yayılmaz). Şema varsayılanı 'overview' varsayılan sekme listesine göredir — kendi key'lerini yazdığında selected'ı da yaz, yoksa ilk seçilebilir sekme açılır.",
|
|
955
|
-
isLoading: "Yayında ve önizlemede açık sekmenin içeriğini gizler, yerine gösterge çizer. Kanvasta (editör) içerik GÖRÜNÜR ve düzenlenebilir kalır, gösterge üstüne biner — tasarımcı yükleniyor açıkken de sekmeye bileşen bırakabilir (2026-09-30, QA TB-001; öncesinde kanvasta içerik gizleniyor, bırakma alanı ölüyordu).",
|
|
956
920
|
variant: "container (varsayılan): başlıklar zemin şeridinde, açık sekme kart gibi; default: alt çizgili düz başlıklar. Yazılmazsa container çizilir (2026-09-15 öncesi yazılmamış düğüm default çiziyordu).",
|
|
957
921
|
headerAlign: 'Başlık satırının hizası: left (varsayılan) · center · right · stretch (sekmeler satırı eşit genişlikte paylaşır; metni sığmayan sekme kendi metni kadar genişler).',
|
|
958
|
-
hideTabs: 'Başlık satırını gizler; içerik yalnız selected ile değişir.'
|
|
959
|
-
isHidden: 'Ortak katman görünürlüğü: true iken sekme grubu hiç kurulmaz — başlıklar da içerik de DOM’a girmez, içindeki bileşenlerin mount olayları koşmaz. Tek bir sekmeyi gizlemek için bunu değil tabs[i].isHidden kullan.'
|
|
922
|
+
hideTabs: 'Başlık satırını gizler; içerik yalnız selected ile değişir.'
|
|
960
923
|
}
|
|
961
924
|
},
|
|
962
925
|
'collapsible-container': {
|
|
@@ -969,7 +932,7 @@ export const componentKnowledge = {
|
|
|
969
932
|
"Düğümün YÜKSEKLİĞİ bölümün kendisine bağlı değildir: kapanan bölüm kutuyu küçültmez, altında boş alan kalır. Kapandığında yer bırakmaması isteniyorsa düğümün Height kipi auto olmalı (ortak katman, appearance.heightType)."
|
|
970
933
|
],
|
|
971
934
|
propNotes: {
|
|
972
|
-
title:
|
|
935
|
+
title: 'Başlık satırının metni; tıklama alanı başlık ŞERİDİNİN tamamıdır (açıklama satırı ve aradaki boşluk dahil).',
|
|
973
936
|
description: 'Başlığın altındaki ikinci satır. Boş bırakılırsa hiç çizilmez.',
|
|
974
937
|
openButtonText: 'Bölüm KAPALIYKEN düğmede yazan metin; açıkken de close karşılığı yazılmamışsa bu kullanılır.',
|
|
975
938
|
closeButtonText: 'Bölüm AÇIKKEN düğmede yazan metin. Yalnız bunu yazmak kapalı durumu etkilemez: orada varsayılan +/− göstergesi çizilir.',
|
|
@@ -979,10 +942,10 @@ export const componentKnowledge = {
|
|
|
979
942
|
closeButtonVariant: 'Açık durumun düğme rengi; aynı seçenekler.',
|
|
980
943
|
isOpen: 'Bölüm açık mı (varsayılan true). Kullanıcı tıklaması buraya geri yazar; akıştan setter ile yazmak bölümü açar/kapatır ve olay yaymaz.',
|
|
981
944
|
isDisabled: 'Bölümü kilitler: başlık tıklaması ve düğme çalışmaz, kap yarı saydam çizilir. GÖVDEDEKİ komponentleri devre dışı bırakmaz — açık bir bölüm kilitlendiğinde içerik kullanılabilir kalır.',
|
|
982
|
-
isLoading:
|
|
945
|
+
isLoading: 'Gövdeyi kırpıp üstüne yükleniyor göstergesi koyar. Önizlemede ve runtime tarafında bölüm kapalıyken görünmez (gövde yok); kanvasta gövde her zaman çizildiği için orada kapalı bölümde de görünür.',
|
|
983
946
|
isHidden: 'Düğümü hiç kurmaz: kapalı bir bölüm değil, olmayan bir bölümdür (ortak katman).',
|
|
984
947
|
style: 'BEM parçaları: &__header (başlık şeridi) ve &__body (gövde).',
|
|
985
|
-
surfaceStyle:
|
|
948
|
+
surfaceStyle: NODE_SURFACE_NOTE
|
|
986
949
|
}
|
|
987
950
|
},
|
|
988
951
|
'tree-view': {
|
|
@@ -992,7 +955,7 @@ export const componentKnowledge = {
|
|
|
992
955
|
"key satırın kimliğidir ve METİN olarak karşılaştırılır (selected '7' ile data key 7 eşleşir). key'i boş/eksik satır hiç seçili çizilmez ve onay kutusu kilitlidir (yalnız ebeveyninden durum alır); aynı seviyede key tekrar ederse ya da eksikse ağaç kırılmaz ama selected/checkedKeys o satırları ayırt edemez — sorgudan kurarken benzersiz id'yi key'e eşle.",
|
|
993
956
|
'selected akıştan yazıldığında o düğüme giden dallar KENDİLİĞİNDEN açılır (yalnız açar; kullanıcının elle açtıklarını kapatmaz). Satır verisindeki isExpanded:true de kendi başına açar.',
|
|
994
957
|
"isCheckable:true her satırın soluna onay kutusu koyar; işaretli key'ler checkedKeys dizisidir. Bir üst satırın key'i TÜM dalı temsil eder: checkedKeys'e yalnız ebeveyn yazmak altındaki bütün etkin satırları işaretler; etkin çocuklarının hepsi işaretli ebeveyn işaretli, bir kısmı işaretliyse yarım (—) çizilir. Kutuya tıklamak dalı birlikte işaretler/kaldırır. isDisabled satırın kutusu kilitlidir ve zincir onda durur: ebeveynin işareti ona ve altına inmez, o da ebeveynin durumuna sayılmaz (altındaki etkin satırlar tek tek işaretlenebilir).",
|
|
995
|
-
"change yalnız kullanıcı kutuya tıklayınca yayılır (akışın checkedKeys yazması yaymaz). Yazılan checkedKeys normalize edilmiştir: tam işaretli her satır belge sırasıyla (tamamlanan ebeveyn dahil); ağaçta çizilmeyen key'ler (gizli satır, henüz yüklenmemiş veri) sona olduğu gibi eklenir. Satır tıklaması (click/selected) ile kutu (change/checkedKeys) birbirinden bağımsızdır. checkedKeys
|
|
958
|
+
"change yalnız kullanıcı kutuya tıklayınca yayılır (akışın checkedKeys yazması yaymaz). Yazılan checkedKeys normalize edilmiştir: tam işaretli her satır belge sırasıyla (tamamlanan ebeveyn dahil); ağaçta çizilmeyen key'ler (gizli satır, henüz yüklenmemiş veri) sona olduğu gibi eklenir. Satır tıklaması (click/selected) ile kutu (change/checkedKeys) birbirinden bağımsızdır. checkedKeys (ya da selected) {{ }} ifadesine bağlıysa kullanıcının tıklaması ifadeyi o düğümde ezer ve kalır; ifadede adı geçen bir düğüm değişince bağ yeniden koşar ve seçimi ifadenin sonucuyla değiştirir (ARC-147, 2026-09-29'dan önce prop bozuluyordu). Seçimin kalıcı olması gerekiyorsa başlangıç listesini statik yaz ya da akıştan self.checkedKeys = [...] ile ver.",
|
|
996
959
|
"actions komponent düzeyinde BİR KEZ tanımlanır, her satır aynı menüyü çizer; bir satır farklılaşacaksa veri öğesine _actions dizisi konur ve SIRA numarasıyla şablonun üstüne biner (o satırda gizleme / etiket değiştirme).",
|
|
997
960
|
"Aksiyonlar set_event ile DEĞİL her aksiyonun kendi flow prop'uyla bağlanır; şema olayı yayılmaz. Aksiyonun akışında satır self.currentItem'da, event.data'da { currentItem, actionKey } (actionKey: aksiyonun key'i) gelir. flow'u boş aksiyon hiçbir şey yapmaz.",
|
|
998
961
|
'isSearchable:true arama kutusunu + tümünü aç/kapat düğmelerini açar. Süzme text ve subtle alanlarında geçer, eşleşenin ataları yerinde kalır, eşleşenin alt ağacı bütün görünür ve süzme sürerken dallar açık çizilir (chevron o sırada etkisizdir). Süzme İSTEMCİ tarafındadır: sunucuda arama gerekiyorsa kutuyu kapatıp kendi textinput + akış çiftini kur. Arama sürerken onay durumu TAM ağaçtan hesaplanır ve bir ebeveyni işaretlemek aramanın gizlediği çocuklarını da işaretler.',
|
|
@@ -1119,11 +1082,10 @@ export const componentKnowledge = {
|
|
|
1119
1082
|
'İKON: tür ikonu (information info · success check_circle · warning warning · error error) showIcon ile kapatılabilir, icon prop ile başka bir Material Symbols adıyla değiştirilebilir. Rengi her zaman tür verir, ikon seçicide renk alanı YOKTUR — renk bu bandda anlamın kendisidir.'
|
|
1120
1083
|
],
|
|
1121
1084
|
propNotes: {
|
|
1122
|
-
header:
|
|
1123
|
-
content:
|
|
1085
|
+
header: 'Kalın yazılan başlık; ekranda ardına İKİ NOKTA eklenir ve metnin başına akar (ayrı satır değildir). Başlıksız band için boş bırak.',
|
|
1086
|
+
content: 'Bandın metni. Tek satır gerekmez, kutu büyür; uzun kelimeler satır sonunda bölünür.',
|
|
1124
1087
|
showIcon: 'Tür ikonunu çizer. false iken ikon kolonu hiç oluşturulmaz (metin sola yaslanır) ve panelde icon alanı gizlenir.',
|
|
1125
|
-
|
|
1126
|
-
icon: "Tür ikonunu ezen Material Symbols adı; düz metin ('star') ya da ikon seçicinin { name } nesnesi. Boş bırakılırsa tür ikonu çizilir; renk yine türden gelir (nesnedeki color yok sayılır). Panelde alan yalnız showIcon false iken gizlenir (2026-10-01, QA NF-002; öncesinde showIcon yazılmamış düğümde de gizleniyordu).",
|
|
1088
|
+
icon: 'Tür ikonunu ezen Material Symbols adı. Boş bırakılırsa tür ikonu çizilir; renk yine türden gelir.',
|
|
1127
1089
|
timeout: 'Milisaniye. Bileşen GÖRÜNÜR olduğu sürece sayar, süre dolunca close yayar ve props.isHidden true olur. 0, boş ya da sayı olmayan değer kendiliğinden kapanma YOK demektir.',
|
|
1128
1090
|
kind: 'information | error | success | warning — rengi ve ikonu birden seçer. Buton ve toast sözlüğünden farklıdır (orada info/primary/default var): akıştan info gelirse komponent information, danger gelirse error okur, bilinmeyen değer information olur. Panel açılır listesinde yalnız dört değer görünür.',
|
|
1129
1091
|
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.',
|
|
@@ -1152,13 +1114,11 @@ export const componentKnowledge = {
|
|
|
1152
1114
|
breadcrumb: {
|
|
1153
1115
|
summary: 'Tek satırlık sayfa yolu: homeTitle (kök) + items (aradakiler) + currentTitle (bulunulan sayfa). Adresi olan öğe bağlantıdır, tıklama ayrıca clickItem yayar. KAPSAYICI DEĞİLDİR.',
|
|
1154
1116
|
behavior: [
|
|
1155
|
-
"BOŞ İZ (BC-002, 2026-09-30): homeTitle, items ve currentTitle üçü de boşken (ve yüklenmiyorken) kök etiketsiz bir div'dir — ekran okuyucuya boş bir gezinme bölgesi duyurulmaz; bir parça dolunca ya da isLoading açılınca yeniden nav olur.",
|
|
1156
|
-
"2026-09-30 (page-header QA PH-001/002/006/008/010): kırıntı satırdan geniş olamaz — uzun metin üç noktayla kısalır, tam ad title'da, ayraç kısalmaz. Kırıntı rengi --ng-text-secondary (eskiden --ng-text-disabled, 2.92:1 — bağlantı devre dışı görünüyordu). Ayraç '/' CSS alternatif metni boş olduğu için erişilebilir ada karışmaz. nav aria-label sayfa dilinden gelir ('Gezinti yolu' / 'Breadcrumb'). Yükleme çubukları --ng-border-primary tonunda.",
|
|
1157
1117
|
'Üç parça ayrı prop’tur ve sırası sabittir: homeTitle → items → currentTitle. Metni boş olan parça HİÇ çizilmez, yani yalnız items vererek köksüz bir iz de kurulabilir. Ayraç (/) bileşenin kendi CSS’indedir, prop’u yoktur; son öğeden sonra basılmaz.',
|
|
1158
1118
|
"Öğenin türü adresine ve olay bağına göre seçilir: href çözülüyorsa <a> (iç adres SPA gezinmesi, dış adres / mailto / tel doğrudan tarayıcı), href yoksa ve clickItem bir akışa bağlıysa <button>, ikisi de yoksa düz metin. 2026-09-17'den önce HER öğe <button> + goto() idi: dış adresler SvelteKit 2'de hata verip hiçbir yere gitmiyordu, bulunulan sayfa ise hiçbir şey yapmayan bir düğmeydi.",
|
|
1159
1119
|
'currentTitle tıklanabilir değildir (aria-current="page"); kip etiketi (Yeni/Düzenle) gibi kullanılacaksa akış bu prop’a setter ile yazar.',
|
|
1160
1120
|
"items dizi DEĞİLSE (temizlenmiş prop null, henüz dolmamış {{ }} ifadesi, düz nesne) iz BOŞ çizilir — 2026-09-17'den önce bileşen bu durumda çizim sırasında patlıyordu. Satır { title, href } bekler ama düz metin dizisi (['Müşteriler','Ahmet']) ve title yerine label yazan satır da okunur; metinsiz satır düşer, düşen satır olay yükündeki index'i KAYDIRMAZ.",
|
|
1161
|
-
'İz sarılır: tek satıra sığmayan kırıntı alt satıra iner (düğüm yüksekliği yetmiyorsa Size’dan artır, maxHeight
|
|
1121
|
+
'İz sarılır: tek satıra sığmayan kırıntı alt satıra iner (düğüm yüksekliği yetmiyorsa Size’dan artır, maxHeight 6 satırdır). Uzun bir izi tek satırda toplayıp "…" menüsüne indiren varyant AYRI bir komponenttir: breadcrumb-title.',
|
|
1162
1122
|
'Olaylar: mount · clickItem. Sayfa başlığıyla birleşik, kip etiketli, ikonlu ya da katlanan bir iz isteniyorsa breadcrumb-title kullanılır; page-header ise bu komponenti kendi links/pageTitle prop’larıyla İÇİNDE çizer.'
|
|
1163
1123
|
],
|
|
1164
1124
|
propNotes: {
|
|
@@ -1172,10 +1132,8 @@ export const componentKnowledge = {
|
|
|
1172
1132
|
}
|
|
1173
1133
|
},
|
|
1174
1134
|
'page-header': {
|
|
1175
|
-
summary: 'Sayfa başlığı bandı: links dizisinden çizilen kırıntı izi + ALTINDA
|
|
1135
|
+
summary: 'Sayfa başlığı bandı: links dizisinden çizilen kırıntı izi + ALTINDA h1 olarak pageTitle. İzdeki adresli öğe bağlantıdır, tıklama ayrıca clickItem yayar. KAPSAYICI DEĞİLDİR.',
|
|
1176
1136
|
behavior: [
|
|
1177
|
-
"2026-09-30 QA turu (PH-001…010): kök bir <div>'dir, <header> DEĞİL — sayfada banner yer imi oluşturmaz. Başlık etiketi headingLevel'dır (sekme/modal içindeki ikinci bantta h2/h3 ver; tanınmayan değer h1). pageTitle boşken başlık elemanı HİÇ çizilmez. isLoading'de başlık iskeleti bandın %40'ını (en az 10rem) kaplar. İz kırıntıları kutudan geniş olamaz: uzun kırıntı üç noktayla kısalır, tam ad title'da; bağlantılar ikincil metin renginde (≈8.4:1), bulunulan sayfa birincil renkte; ayraç '/' erişilebilir ada karışmaz; izin aria-label'ı sayfa dilinde ('Gezinti yolu').",
|
|
1178
|
-
"STUDIO PANELİ: Common'da pageTitle, headingLevel, links, isLoading; Style sekmesi stil kurucusudur — Preset · Spacing · Size · Breadcrumb style (breadcrumbStyle) · Custom properties (style). 2026-09-30'dan önce breadcrumbStyle panelde hiçbir yerde yoktu.",
|
|
1179
1137
|
'İki katman, sırası sabit: üstte iz (links), altında başlık (pageTitle). İzi çizen breadcrumb komponentinin KENDİSİDİR (links → items, pageTitle → currentTitle, breadcrumbStyle → style): öğe türü seçimi (<a> / <button> / düz metin), sarma, düz metin dizisi ve label anahtarı okuma breadcrumb ile birebir aynıdır. Kök öğe (homeTitle) YOKTUR — kök gerekiyorsa links’in ilk satırı olarak yazılır; varsayılan Homepage satırı tam bunu yapar.',
|
|
1180
1138
|
"links boşsa ya da dizi değilse (temizlenmiş prop null, henüz dolmamış {{ }} ifadesi) iz HİÇ çizilmez, yalnız başlık kalır — 2026-09-18'den önce dizi olmayan links çizim sırasında patlıyordu (links.length).",
|
|
1181
1139
|
'pageTitle izin SON öğesi olarak da basılır (tıklanamaz, aria-current="page") — başlığı links’e bir daha yazma. pageTitle boşsa başlık satırı boş kalır ve izde bulunulan sayfa öğesi çizilmez.',
|
|
@@ -1184,7 +1142,6 @@ export const componentKnowledge = {
|
|
|
1184
1142
|
'Düğüm boyu: başlık tek başına 40px (4 ızgara satırı), izle birlikte ≈ 62px (7 satır). Auto yükseklikle bırakılırsa içerik kadar uzar; sabit yükseklikte maxSize.h 12’dir — eski 4 satır sınırı izli başlığı sığdıramıyor, tutamaçtan boyutlandırılan düğümü 40px’e çökertiyordu (2026-09-18’de düzeltildi).'
|
|
1185
1143
|
],
|
|
1186
1144
|
propNotes: {
|
|
1187
|
-
headingLevel: "Başlığın etiketi: 'h1' (varsayılan) | 'h2' | 'h3'. Sayfanın ANA başlığı h1 kalsın; aynı sayfadaki ikinci bir bant (sekme, modal, bölüm) h2/h3 almalı — ikinci h1 başlık hiyerarşisini bozar. Boyut temanın o seviyedeki ölçeğinden gelir.",
|
|
1188
1145
|
pageTitle: "Bant başlığı (h1) VE izin son öğesi; page_container.title ile karıştırılmamalı. `description` / altbaşlık diye bir prop YOKTUR (unknown-prop verir) — açıklama satırı için bandın altına ayrı bir text düğümü koy.",
|
|
1189
1146
|
links: "Kırıntı izinin öğeleri: [{ title, href }], başlığın ÜSTÜNDE soldan sağa. Sağ tarafta aksiyon bağlantısı ÇİZMEZ (eski kayıt böyle diyordu, runtime hiç öyle çizmedi). Akıştan gelen düz metin dizisi ve label anahtarı da okunur; metinsiz satır düşer. Dizi olmayan değer = iz yok (hata değil).",
|
|
1190
1147
|
isLoading: 'true iken iz ve başlık yerine iskelet çubukları çizilir, hiçbir öğe basılmaz, clickItem yayılmaz — links’i mount akışından dolduran ekranda boş bandın görünmesini engeller. mount BUNDAN BAĞIMSIZDIR.',
|
|
@@ -1195,22 +1152,16 @@ export const componentKnowledge = {
|
|
|
1195
1152
|
}
|
|
1196
1153
|
},
|
|
1197
1154
|
header: {
|
|
1198
|
-
summary: "Uygulama üst çubuğu (layout parçası): logo,
|
|
1155
|
+
summary: "Uygulama üst çubuğu (layout parçası): logo, TEK SEVİYE bağlantı şeridi, kullanıcı bloğu; navigation dizisi iç içe Prop sarmalı ister. Aktif bağlantı vurgusu YALNIZ prop'la sürülür — sidebar/layout'un aksine adrese bakmaz.",
|
|
1199
1156
|
behavior: [
|
|
1200
1157
|
"Vurgu OTOMATİK DEĞİLDİR: komponent adres çubuğuna bakmaz, yalnız activeNavHref ile bağlantının adresini karşılaştırır. Prop boşken hiçbir bağlantı vurgulanmaz; sayfa değişince vurguyu açılış akışındaki setter yazar. (Otomatiği isteyen sidebar/layout ya da qm-header kullanır.)",
|
|
1201
1158
|
"Karşılaştırma ÇÖZÜLMÜŞ yol üzerindedir (iki taraf da getHref'ten geçer): activeNavHref'e satırın ham href'ini ('musteriler'), bağlantı nesnesini ya da tarayıcıdaki tam yolu yazabilirsin — üçü de aynı satırı bulur.",
|
|
1202
1159
|
"2026-08-27'den önce karşılaştırma HAM değerler üzerindeydi ve bağlantı seçicisiyle doldurulmuş (nesne) href hiçbir zaman tutmuyordu; artık iki taraf da getHref'ten geçiyor — ham metin, bağlantı nesnesi ve tam yol aynı bağlantıyı gösterir.",
|
|
1203
|
-
"
|
|
1204
|
-
"Vurgulanan öğe vurgu rengi + alt çizgi alır ve aria-current='page' taşır (HDR-003); alt menüdeki bir sayfadayken üst öğe de vurgulanır. 2026-09-29'dan önce vurgu hover ile aynı zemin tonuydu ve açık temada görünmüyordu.",
|
|
1205
|
-
"DAR EKRAN (HDR-001, 2026-09-29): ≤1023px'te menü, şeritteki menü düğmesinin (aria-expanded) açtığı panele döner. Panel şeridin İÇİNDE akar — şerit uzar ve sayfayı aşağı iter; kaplar overflow ile kesemesin diye taşan katman değildir. ≤767px'te kullanıcı alanı rozete/ikona iner (ad ekran okuyucu için okunur kalır).",
|
|
1206
|
-
"Logo boşsa ya da yüklenemezse çizilmez (HDR-004); logoHref boşsa logo bağlantı değildir. logoHref ve userHref bağlantı seçicidir ve ikisi de menü gibi getHref'ten geçer (HDR-005). Kök <header>, menü <nav aria-label> (HDR-006)."
|
|
1160
|
+
"navigation öğesi children alt-prop'unu kabul eder ama Header.svelte alt menü ÇİZMEZ — dizi tek seviye basılır. İç içe menü gerekiyorsa sidebar/layout (activeHref + otomatik vurgu) ya da qm-header (yalnız otomatik vurgu) kullan."
|
|
1207
1161
|
],
|
|
1208
1162
|
propNotes: {
|
|
1209
|
-
activeNavHref: "Vurgulanacak bağlantının href'i
|
|
1210
|
-
navigation: "[{ title, href
|
|
1211
|
-
surfaceStyle: STYLE_GROUP_NOTES.surfaceStyle + ' ' + STYLE_GROUP_NOTES.colorTokens + " Şerit KENDİ derler (HDR-007, 2026-09-29): değer şeridin köküne iner; alt çizgi için borderBottom.",
|
|
1212
|
-
style: "Parçalar: &__logo, &__title, &__navigations, &__navigations-item, &__navigations-item-suffix, &__submenu, &__submenu-item, &__menu-toggle, &__user, &__user-icon, &__user-short, &__user-name.",
|
|
1213
|
-
userShortName: "Doluysa ad yerine rozet, boşsa account_circle ikonu çizilir. userName boşsa kullanıcı alanı hiç çizilmez."
|
|
1163
|
+
activeNavHref: "Vurgulanacak bağlantının HAM href'i. Eşleşen öğeye 'active' sınıfı basılır; görsel fark yalnız arka plan tonudur (--ng-background-canvas) ve o ton hover'ın aynısıdır — kalınlık/renk değişmez (header.style.ts '&__navigations-item.active').",
|
|
1164
|
+
navigation: "[{ title, href, icon }] — tek seviye. children yazılabilir ama render EDİLMEZ."
|
|
1214
1165
|
}
|
|
1215
1166
|
},
|
|
1216
1167
|
sidebar: {
|
|
@@ -1220,56 +1171,28 @@ export const componentKnowledge = {
|
|
|
1220
1171
|
"Eşleşmenin iki tarafı da getHref'ten geçer: satırın ham href'ini ('musteriler'), bağlantı seçicisinin nesnesini ({type:'page', data, ref}) ya da tarayıcıdaki tam yolu yazmak AYNI satırı gösterir — header'ın ham eşitlik tuzağı burada yok.",
|
|
1221
1172
|
"Otomatik eşleşme kuralı: satırın yolu adresle TAM eşit olmalı, satırın istediği sorgu parametrelerinin hepsi adreste aynı değerle bulunmalı (sayfanın eklediği fazla parametreler yok sayılır); aynı yolu paylaşan satırlarda daha çok parametre eşleyen kazanır. Yalnız YAPRAK satırlar yarışır, gizli satırlar elenir. Adres mount'ta BİR KEZ okunur (bağlantılar tam sayfa yükler).",
|
|
1222
1173
|
"Vurgulanan satır 'nav-btn--active' sınıfı + aria-current='page' alır (accent zemin/metin, hover tonundan bilerek ayrı). ÜST DAL vurgulanmaz ve kendiliğinden AÇILMAZ — kapalı bir dal aktif satırı gizler.",
|
|
1223
|
-
"
|
|
1224
|
-
"DAR EKRAN (SB-001, 2026-09-29): ≤1023px'te ızgara alanında yalnız menü düğmesi (aria-expanded) kalır; menü ekranın solundan açılan bir çekmecedir (min(300px, 85vw), overlay, role=dialog). Overlay, Escape ve genişliğin 1023'ü aşması kapatır. Tuvalde çekmece yoktur.",
|
|
1225
|
-
"KAYDIRMA (SB-002): kök ekran yüksekliğindedir ve taşmaz; uzun menü içerik alanının İÇİNDE kayar.",
|
|
1174
|
+
"Menü rengi/biçimi CSS ile hâlâ ezilemez: style'ın &__navigations, &__navigations-title, &__navigations-body, &__navigations-item, &__navigations-item-suffix parçaları ÖLÜDÜR — bu sınıflar hiçbir elemana basılmaz (Sidebar.svelte yalnız __header*/__content yazar, satırları Navigations kendi scoped .nav-btn sınıfıyla çizer). Vurgu bu yüzden komponentin kendi stilindedir (zeyrek-frontend docs/issues.md CQ-132).",
|
|
1226
1175
|
"Menü olay YAYMAZ (şemada yalnız mount), satır tıklaması akış tetiklemez — gezinme ham <a href> ile tam sayfa yükleyerek olur.",
|
|
1227
1176
|
"isExpandable:true olan öğe BUTON çizilir ve href'i YOK SAYILIR (yalnız açar/kapar); gezinen, href'i olup isExpandable olmayan yapraklardır. Ne href'i ne children'ı olan 0. seviye öğe tıklanamaz GRUP BAŞLIĞI olur.",
|
|
1228
|
-
"isExpanded kullanıcı tıklayınca yalnız bellekteki öğe nesnesinde değişir — akışa yayılmaz, sayfa yenilenince şemadaki değere döner."
|
|
1229
|
-
"BAŞLIK BANDI yalnız logo ya da title doluyken çizilir; subtle bu bandın içindedir, yani title ve logo boşsa subtle da GÖRÜNMEZ. Band sabit kalır, altındaki menü kayar.",
|
|
1230
|
-
"YERLEŞİM: 12 kolonluk ızgarada 1–2 kolon genişliğinde (varsayılan 2), yüksekliği blok değil ekran boyudur; isDroppable false — içine bileşen bırakılmaz, içerik yalnız navigations ağacıdır. Sayfa kabının kendi dolgusu yüzünden masaüstünde sayfa ~8px fazla kayabilir; sidebar'ın kutusundan değil.",
|
|
1231
|
-
"isHidden:true sidebar'ı ve menüsünü tamamen kaldırır (dar ekrandaki menü düğmesi dahil).",
|
|
1232
|
-
"STUDIO PANELİ: Common'da title, logo, subtle, navigations, activeHref; Style sekmesinde Preset, Spacing, Size, Surface (surfaceStyle), Menu items (navigationStyle), Custom properties (style) bölümleri."
|
|
1177
|
+
"isExpanded kullanıcı tıklayınca yalnız bellekteki öğe nesnesinde değişir — akışa yayılmaz, sayfa yenilenince şemadaki değere döner."
|
|
1233
1178
|
],
|
|
1234
1179
|
propNotes: {
|
|
1235
|
-
title: "Başlık bandındaki ad; logonun alt metni de budur (boşsa alt metin boş kalır, sabit ürün adı yoktur — SB-005).",
|
|
1236
|
-
logo: "image bileşeniyle 40px yükseklikte çizilir; adres yüklenemezse image'in yedek kutusu (kırık resim ikonu) görünür, düzen bozulmaz.",
|
|
1237
|
-
subtle: "Başlığın altındaki kısa açıklama; yalnız title ya da logo doluyken çizilir.",
|
|
1238
|
-
isHidden: "true → sidebar tamamen kalkar.",
|
|
1239
1180
|
navigations: "Ağaç: { title, href, icon, isExpandable, isExpanded, children }. href hem düz metin hem bağlantı seçicisinin nesnesi ({ type:'page', data, ref }) olabilir; ikisini de getHref çözer (http/mailto/tel olduğu gibi geçer, aksi hâlde geçerli adresin ilk üç segmentinin altına bağlanır). Öğe bazlı isHidden bu şemada YOKTUR — layout'ta vardır.",
|
|
1240
|
-
activeHref: "Vurgulanacak satırın adresi; boş bırakılırsa tarayıcıdaki adres karar verir. Satırın href'iyle aynı biçimde yazılabilir (ham metin, bağlantı nesnesi ya da tam yol).",
|
|
1241
|
-
style: "
|
|
1242
|
-
navigationStyle: "Menü satırlarının görünümü — layout'taki navigationStyle ile aynı alanlar: padding, radius, textColor, iconColor, hoverBackground, activeBackground, activeTextColor, activeIconColor. Hepsi boş başlar; boş alan temadan gelir.",
|
|
1243
|
-
surfaceStyle: STYLE_GROUP_NOTES.surfaceStyle + ' ' + STYLE_GROUP_NOTES.colorTokens + " Yan menü KENDİ derler (SB-004, 2026-09-29): değer kökün zeminine iner; sağ çizgi için borderRight."
|
|
1244
|
-
}
|
|
1245
|
-
},
|
|
1246
|
-
'auth-layout': {
|
|
1247
|
-
summary: 'Giriş ekranı kabuğu: logo kolonu + form slotu; primaryClick/secondaryClick olayları yayar.',
|
|
1248
|
-
behavior: [
|
|
1249
|
-
"ENTER (AUTH-001/002/003, 2026-09-29): odak bileşenin İÇİNDEKİ tek satırlı bir alandayken ve primaryText dolu, primaryDisabled kapalıyken Enter primaryClick yayar. textarea/contenteditable'da yeni satırdır; odaktaki düğme, bağlantı ve select kendi Enter davranışını korur; sayfanın başka yerindeki Enter formu göndermez. Önceden pencere düzeyinde HER Enter yutuluyordu.",
|
|
1250
|
-
"Tam ekran kendi kuralıyla gelir (min-height 100dvh); form kendi içinde kaydırmaz, uzun formda kolon ve sayfa uzar (AUTH-004/005). Kök artık ng-layout sınıfı taşımaz.",
|
|
1251
|
-
"backdrop boşsa ya da verilen resim yüklenemezse paketle gelen /images/auth-bg.jpg görünür (iki katmanlı background-image). Logo yüklenemezse gizlenir; alt metni boştur (başlık zaten h1)."
|
|
1252
|
-
],
|
|
1253
|
-
propNotes: {
|
|
1254
|
-
surfaceStyle: STYLE_GROUP_NOTES.surfaceStyle + ' ' + STYLE_GROUP_NOTES.colorTokens + " Bileşen KENDİ derler (AUTH-006, 2026-09-29): değer .ng-auth KÖKÜNE (içerik kolonunun zemini) iner.",
|
|
1255
|
-
style: "Serbest CSS kaçış kanalı; parçalar: &__background (sol, resimli kolon), &__content (sağ, formlu kolon), &__title (başlık).",
|
|
1256
|
-
backdrop: "Varsayılan boş — paketle gelen yedek resim kullanılır.",
|
|
1257
|
-
primaryDisabled: 'Birincil düğmeyi ve Enter ile gönderimi birlikte kapatır.'
|
|
1181
|
+
activeHref: "Vurgulanacak satırın adresi; boş bırakılırsa tarayıcıdaki adres karar verir. Satırın href'iyle aynı biçimde yazılabilir (ham metin, bağlantı nesnesi ya da tam yol). YENİ prop — component_get çıktısındaki prop listesinde görünmüyorsa platform kataloğu henüz senkronlanmamıştır (components.json CI'daki syncComponents adımıyla iner).",
|
|
1182
|
+
style: "Yalnız &__header, &__header-logo, &__header-title, &__header-subtle ve &__content gerçekten uygulanır; &__navigations* parçaları ölüdür (bkz. davranış)."
|
|
1258
1183
|
}
|
|
1259
1184
|
},
|
|
1185
|
+
'auth-layout': { summary: 'Giriş ekranı kabuğu: logo kolonu + form slotu; primaryClick/secondaryClick olayları yayar.', propNotes: { surfaceStyle: NODE_SURFACE_NOTE } },
|
|
1260
1186
|
layout: {
|
|
1261
1187
|
summary: 'Layout kök komponenti: logo/başlık, kullanıcı menüsü, kırıntı yolu ve menü ağacı bir arada; sayfalar slot’una yerleşir, logout olayı yayar.',
|
|
1262
1188
|
behavior: [
|
|
1263
1189
|
"Menü ağacını sidebar ile AYNI renderer çizer (Navigations/NavigationsItem): activeHref prop'u, adresten otomatik eşleşme, isExpandable/isExpanded ve grup başlığı kuralları birebir aynıdır — ayrıntı sidebar kaydında.",
|
|
1264
1190
|
"Öğe bazlı isHidden BU şemada tanımlıdır (sidebar'ınkinde yoktur): true olan öğe canlıda elenir, Studio'nun düzenleyici kipinde görünmeye devam eder.",
|
|
1265
1191
|
"TEK PARÇA (monolit) kabuktur: logo, başlık, menü, kırıntı yolu ve kullanıcı menüsü sabittir — yalnız DOLDURULUR, yeniden düzenlenemez. Serbest kompozisyon için container + slot kullan (platform_guide('layout')); mevcut monolitler çalışmaya devam eder ve Studio'da 'Break apart' ile parçalarına ayrılabilir.",
|
|
1266
|
-
"İÇERİK ALANI BİR KAPTIR (2026-09-03): container ile aynı yedi yerleşim prop'unu taşır (layout/direction/horizontalAlign/verticalAlign/size/gap/wrap, katalog varsayılanı layout:'flex'); slot ve içine bırakılan başka çocuklar bu akışla dizilir. Studio'nun
|
|
1267
|
-
"MOBİL (≤767px, 2026-09-29): sidebar kapalı başlar ve içerik başlığındaki düğmeyle overlay'li çekmece olarak açılır; menü satırları çekmecenin içinde DOĞRUDAN görünür (gömülü menü kendi hamburger'ine dönmez). Sidebar'ın açık/kapalı durumu prop DEĞİLDİR — akıştan açılıp kapatılamaz, page_screenshot actions ile de tıklanamaz (düğmenin elementId'si yok).",
|
|
1268
|
-
"Logo yüklenemezse (bozuk URL) icon'a düşer; icon.color glifin rengidir. userAvatar boşsa ya da yüklenemezse kırık resim yerine person ikonlu kutu çizilir."
|
|
1192
|
+
"İÇERİK ALANI BİR KAPTIR (2026-09-03): container ile aynı yedi yerleşim prop'unu taşır (layout/direction/horizontalAlign/verticalAlign/size/gap/wrap, katalog varsayılanı layout:'flex'); slot ve içine bırakılan başka çocuklar bu akışla dizilir. Studio'nun yeni kabuk iskeleti (getDefaultLayout) düğüme layout:'flex' + verticalAlign:'stretch' + gap:'none' yazar. Prop hiç yazılmamış eski kayıtlar ızgara çizilmeye devam eder — container'daki kuralın aynısı."
|
|
1269
1193
|
],
|
|
1270
1194
|
propNotes: {
|
|
1271
|
-
surfaceStyle:
|
|
1272
|
-
" Kabuk yüzeyi KENDİ KÖKÜNDE (.ng-layout) derler (2026-09-29, LAYOUT-006): background kabuğun gri tema zeminini (--ng-background-surface-alt) ezer, boş bırakılırsa tema zemini kalır; contentOverflow kökün kendisine iner (hidden yuvarlatılmış köşeyi kırpar). Katman sırası K4: tema componentStyles → surfaceStyle → düğümün style'ı. Eskiden değer düğüm kutusuna yazılıyor ve zemin kabuğun kendi zemini altında kalıp görünmüyordu.",
|
|
1195
|
+
surfaceStyle: NODE_SURFACE_NOTE,
|
|
1273
1196
|
navigationStyle: NAVIGATION_STYLE_NOTE,
|
|
1274
1197
|
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.",
|
|
1275
1198
|
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ı."
|
|
@@ -1291,29 +1214,22 @@ export const componentKnowledge = {
|
|
|
1291
1214
|
"sidebar düzeninde MARKA ve KULLANICI bileşenin içindedir (2026-09-25): başlık bandı logo/ikon + title + subTitle çizer (logo kutusu uygulamanın ana sayfasına giden bir bağlantıdır — kırıntı yolunun ev halkasıyla aynı hedef), collapsible açıksa daraltma düğmesi bandın SAĞINDADIR (şeritte alt kısma iner). Alt kısım userName/userEmail doluysa kullanıcı düğmesidir (avatar ya da baş harfler, ad, e-posta); tıklanınca yukarı doğru bir panel açılır: ad, e-posta, userPosition, userRole ve 'Çıkış yap'. Panel Escape ve dış tıklamayla kapanır (dismiss-chain). Daraltınca marka, arama ve kullanıcı birlikte şeride iner.",
|
|
1292
1215
|
"Daraltma durumu tarayıcıda (localStorage, 'ng-nav-collapsed:<elementId>') saklanır ve SONRAKİ SAYFADA okunur — menü linkleri tam sayfa yüklediği için bellekteki durum her tıklamada kayboluyordu. Tuvalde okunmaz.",
|
|
1293
1216
|
"Menü içi arama bir ALAN gibi çizilir (kenarlık + açık zemin + '/' ipucu); sayfada yazı alanı dışındayken '/' aramaya odaklanır (kısayolun sayfada tek sahibi vardır). command düzeninin tetikleyicisi de alan görünümündedir ve Ctrl K / ⌘ K ipucu taşır; iki yerde de yer tutucu searchPlaceholder'dır.",
|
|
1294
|
-
"KAPSAYICIDIR (isDroppable, 2026-09-24): layout gibi içine komponent bırakılır ve bırakılan çocuklar menünün YANINDA/ALTINDA kendi içerik alanında çizilir, menü satırlarının arasında değil. Akış yönünü düzen belirler (navigation-content.ts): sidebar/hybrid/dual menü solda içerik sağda — sidebarSide right ise ters; toc tocPosition ile; header/tabs/breadcrumb içerik altta; footer/bottom ve dock bottom içerik üstte (dock top altta); drawer/command/launcher akışta yer kaplamaz, içerik alanı tek başına kalır. İçerik alanı navigations dizisi BOŞKEN de durur — son menü öğesi silinince bırakılan bileşenler kaybolmaz. İçine hiçbir şey bırakılmamışsa alan akıştan çıkar (menünün yanına boşluk düşmez); kenara yapışık panelde (sidebar/hybrid/dual, floating değil) menü ile içerik arasında boşluk YOKTUR, panelin kenarlığı ayırır. Bırakılan içerik alanın boyunu doldurur (fill zinciri) — yan menü + içerik sütunu kabuğu tek navigations ile kurulabilir. Kanvasta çocukların çizilmesi için kayıtlı düğümde states.isDroppable true olmalı.
|
|
1217
|
+
"KAPSAYICIDIR (isDroppable, 2026-09-24): layout gibi içine komponent bırakılır ve bırakılan çocuklar menünün YANINDA/ALTINDA kendi içerik alanında çizilir, menü satırlarının arasında değil. Akış yönünü düzen belirler (navigation-content.ts): sidebar/hybrid/dual menü solda içerik sağda — sidebarSide right ise ters; toc tocPosition ile; header/tabs/breadcrumb içerik altta; footer/bottom ve dock bottom içerik üstte (dock top altta); drawer/command/launcher akışta yer kaplamaz, içerik alanı tek başına kalır. İçerik alanı navigations dizisi BOŞKEN de durur — son menü öğesi silinince bırakılan bileşenler kaybolmaz. İçine hiçbir şey bırakılmamışsa alan akıştan çıkar (menünün yanına boşluk düşmez); kenara yapışık panelde (sidebar/hybrid/dual, floating değil) menü ile içerik arasında boşluk YOKTUR, panelin kenarlığı ayırır. Bırakılan içerik alanın boyunu doldurur (fill zinciri) — yan menü + içerik sütunu kabuğu tek navigations ile kurulabilir. Kanvasta çocukların çizilmesi için kayıtlı düğümde states.isDroppable true olmalı.",
|
|
1295
1218
|
"İÇERİK ALANININ YERLEŞİMİ container ailesiyle AYNI yedi prop'tur (2026-09-29): layout ('flex' | 'grid', katalog varsayılanı 'flex') + direction/horizontalAlign/verticalAlign/size/gap/wrap, anlamları ve varsayılanları container kaydındakiyle birebir. Bunlar menüyü DEĞİL, menünün yanına bırakılan çocukları dizer (RenderComponent içerik alanındaki .ng-app__node-children sarmalına yazar). Menünün kendi biçimi navLayout, satır yoğunluğu density'dir. layout prop'u 'flex'/'grid' dışında bir değer taşıyan (ya da hiç taşımayan) düğümün içerik alanı 12 kolon IZGARA çizilir.",
|
|
1296
1219
|
"YENİDEN ADLANDIRMA (2026-09-29, ADR 0007): menü düzeni layout → navLayout, satır yoğunluğu size → density. Kayıtlı eski düğümler göç görmedi: navLayout yoksa bileşen eski layout değerini (sidebar/header/… ise) düzen sayar, density yoksa eski size'ı (sm/md/lg ise) — ekranda değişiklik olmaz. AMA backend doğrulayıcısı eski değerli düğüme DOKUNAN patch'i invalid-enum-value ile reddeder (layout artık flex|grid, size shrink|grow): böyle bir düğümü düzenlerken aynı patch'te navLayout'a eski layout değerini, density'ye eski size değerini yaz ve layout'u 'grid' (eski görünüm) ya da 'flex', size'ı 'shrink' yap.",
|
|
1297
1220
|
"sidebar ve layout bileşenleri bu ağacı GÖMÜLÜ kipte mount eder (embedded): panel kromunu — genişlik, kenarlık, zemin, logo, kullanıcı alanı — o kabuklar çizer, navigations ikinci kez çizmez.",
|
|
1298
1221
|
"Satır görünümü TİPLİ navigationStyle grubuyla verilir (layout ile aynı grup); serbest style'ın &__item, &__item--active ve &__icon parçaları gruptan SONRA gelir (son söz).",
|
|
1299
|
-
"DEVRE DIŞI ÖĞE (navigations[].isDisabled, 2026-09-30): hiçbir düzenden GİDİLEMEZ ve kural ÇOCUKLARA GEÇER — devre dışı bir dalın altındaki her sayfa da gidilemez (sidebar devre dışı dalı zaten açmaz). Yüzeye göre iki okuma: 'bul ve git' yüzeyleri — command paleti, launcher karoları, breadcrumb'ın kardeş menüsü — öğeyi HİÇ LİSTELEMEZ; çubuklar — sidebar/header satırı, footer, bottom, dock, toc, breadcrumb yolu — yerini korur ve öğeyi soluk (%45), tıklanamaz, aria-disabled bir span olarak çizer. Bir sayfayı menüde görünür ama kapalı tutmak için isDisabled, tamamen saklamak için isHidden kullan. Eskiden beş düzende devre dışı öğe normal bağlantıydı (QA NAV-QA-001).",
|
|
1300
|
-
"KADEMELİ ÇEKMECE ZİNCİRİ (variant 'drawer' + nestingMode 'cascade'): her dal bir SONRAKİ çekmeceyi açar — kök → Raporlar → Stok üç panel olur; 'side' yan yana (288px aralıkla), 'stack' üst üste (alttakinin 20px'lik şeridi geri dönüş düğmesidir). Her alt çekmecenin başlığında bir önceki seviyenin adı ve geri oku vardır; yalnız EN SON çekmecede kapatma (×) düğmesi bulunur. inlineDepth (varsayılan 2) kadar seviye çekmecenin içinde yerinde açılır, daha derini yeni çekmecedir — inlineDepth 1 ile kökteki her dal doğrudan çekmece açar. Eskiden üçüncü seviye ikincinin yerine geçiyordu (QA NAV-QA-002).",
|
|
1301
|
-
"MOBİL (≤768px, navigation-effective.ts MOBILE_BREAKPOINT): mobileBehavior 'drawer' (varsayılan) iken sidebar/header/hybrid/dual/dock düzenleri 'Main menu' etiketli, aria-expanded taşıyan bir tetikleyiciye ve portal'da açılan çekmeceye döner; Escape ve dış tıklama kapatır. Çekmece genişliği mobilde 312px ve ekranın %88'iyle sınırlanır. cascade mobilde her zaman 'stack' olur, hover ile açma kapanır. GÖMÜLÜ ağaç (layout/sidebar içindeki) mobilde katlanMAZ — kabuğun kendi çekmecesi zaten vardır. 'same' düzeni olduğu gibi bırakır.",
|
|
1302
|
-
"KLAVYE: Tab menü sırasını izler, odak halkası 2px düz çizgidir; dal düğmesinde Enter/Space açar-kapar (aria-expanded + aria-controls). '/' menü içi aramaya, Ctrl/⌘+K komut paletine odaklanır (sayfada her kısayolun TEK sahibi vardır). Palette ↑/↓ seçimi gezer (sonda başa sarar), Enter seçili sayfaya gider, Escape kapatır ve odak tetikleyiciye döner. Açık katman zincirinde Escape yalnız EN ÜST katmanı kapatır (ADR 0002). Palet tetikleyicisi aria-haspopup='dialog' ve açık/kapalı durumunu aria-expanded ile duyurur.",
|
|
1303
|
-
"ÇALIŞMA ANINDA DEĞİŞEN PROP'LAR: görünüm, düzen, renk, girinti ve activeHref setComponentProperty ile anında uygulanır. defaultExpanded ise YALNIZ MOUNT anında okunur — sonradan değiştirmek açık dalları değiştirmez (kullanıcının açıp kapattığı durum korunur). Menü ağacı (navigations) değişince yeni dallar declared isExpanded'larına göre eklenir.",
|
|
1304
|
-
"MCP İLE KURULAN DÜĞÜM: page_schema_patch ile yalnız verilen prop'lar yazılır; yazılmayan her prop ÇALIŞMA ANINDA şemanın varsayılanıyla çizilir (navLayout 'sidebar', variant 'accordion', theme 'light', indent 28, width 256, tileCols 3 …). Studio paneli de 2026-09-30'dan beri eksik skaler prop'u varsayılanıyla gösterir; eskiden 0/boş ve kırmızı görünüyordu (QA NAV-QA-004). Liste ve nesne varsayılanları (örnek menü ağacı) panelde gösterilmez — navigations dizisini her zaman AÇIKÇA yaz.",
|
|
1305
|
-
"DÜZENE ÖZGÜ ETKİLEŞİM: header dalı dropdown/mega panel ya da ikinci satırda sekme açar (hMenuStyle), sığmayanlar 'Daha fazla'ya toplanır; dual'da rail ikonu paneli açar, aynı ikona ikinci basış kapatır; bottom'da dal olan sekme sayfaya gitmez, alttan bir sheet açar, bottomMax aşılınca 'Daha fazla' sheet'i gelir; dock'ta dal ikonu flyout açar; launcher'da dal karosu alt karolara İNER (başlıkta geri oku), yaprak karosu gider; breadcrumb mobilde tek bir 'üst seviye' bağlantısına iner, crumbMax aşılınca ortası '…' menüsüne toplanır; footer'da adresi olan kolon başlığı da bağlantıdır.",
|
|
1306
1222
|
'Karar kayıtları: zeyrek-frontend/docs/adr/0001-navigation-duzen-kaydi.md (düzen kaydı), 0007-navigation-duzen-proplari-yeniden-adlandirildi.md (navLayout/density adları).'
|
|
1307
1223
|
],
|
|
1308
1224
|
propNotes: {
|
|
1309
|
-
navigations: "Ağaç: { title, href, icon, isHidden, isExpandable, isExpanded, children } + görünüm alanları { badge, badgeTone, isDisabled, target }. Alan adları kaydedilmiş sayfaların sözleşmesidir ve değişmedi. href düz metin ya da bağlantı seçicisinin nesnesi ({ type:'page', data, ref }) olabilir; ikisini de getHref çözer.
|
|
1225
|
+
navigations: "Ağaç: { title, href, icon, isHidden, isExpandable, isExpanded, children } + görünüm alanları { badge, badgeTone, isDisabled, target }. Alan adları kaydedilmiş sayfaların sözleşmesidir ve değişmedi. href düz metin ya da bağlantı seçicisinin nesnesi ({ type:'page', data, ref }) olabilir; ikisini de getHref çözer.",
|
|
1310
1226
|
navLayout: "Navigasyonun ekrandaki yeri ve biçimi; 12 seçenek (2026-09-29'a kadar prop'un adı layout idi). Kabuk seçimini bu prop yapar — tek istisna, sidebar ve hybrid düzenlerinde drawer menü tipinin kendi kabuğunu çağırmasıdır (bkz. variant).",
|
|
1311
1227
|
variant: "Menü tipi: 'flat' (alt öğeler hep açık), 'accordion' (açılır/kapanır), 'drawer' (tetikleyiciyle açılan panel). Yalnız sidebar ailesinde anlamlıdır.",
|
|
1312
1228
|
displayMode: "'full' ikon+metin · 'rail' yalnız ikon (alt seviyeler kademeli flyout) · 'text' yalnız metin.",
|
|
1313
1229
|
nestingMode: "Derin seviyeler nasıl açılır: 'inline' | 'drill' | 'cascade'. Rail'de her zaman cascade'e zorlanır.",
|
|
1314
1230
|
inlineDepth: 'Bir panelde yerinde gösterilecek seviye sayısı; daha derini drill/flyout/alt drawer ile açılır.',
|
|
1315
1231
|
drillHeader: "Drill panelinin başlığı: 'back' (geri + başlık) | 'path' (kısa yol, gizli seviyeler üç noktada) | 'switcher' (tüm yolu açan seviye seçici).",
|
|
1316
|
-
cascadeLayout: "Alt drawer'ların dizilişi: 'side' yan yana | 'stack' üst üste. Sığmazsa
|
|
1232
|
+
cascadeLayout: "Alt drawer'ların dizilişi: 'side' yan yana | 'stack' üst üste. Sığmazsa ve mobilde otomatik stack.",
|
|
1317
1233
|
activeHref: 'Vurgulanacak satırın adresi; boş bırakılırsa tarayıcıdaki adres karar verir.',
|
|
1318
1234
|
isHidden: 'Komponentin tamamını gizler (ortak katman prop’u); öğe bazlı gizleme navigations[].isHidden’dır.',
|
|
1319
1235
|
theme: "Temel renk şeması: 'light' | 'dark' | 'brand'. Renkler bölümündeki her prop bunun üstüne yazılır; boş bırakılan tema değerinde kalır.",
|
|
@@ -1360,14 +1276,14 @@ export const componentKnowledge = {
|
|
|
1360
1276
|
cmdGroupBy: "Sonuçlar 'group' ile kendi menü grubu başlıkları altında, 'none' ile tek düz liste olarak gösterilir. Yalnız command düzeninde geçerlidir.",
|
|
1361
1277
|
cmdShowPaths: "Her sonucun altında sayfanın yolunu yazar — aynı adlı iki sayfa ancak böyle ayırt edilir. Yalnız command düzeninde geçerlidir.",
|
|
1362
1278
|
launcherMode: "'popover' ızgara küçük bir panelde açılır; 'page' tüm sayfayı kaplar. Yalnız launcher düzeninde geçerlidir.",
|
|
1363
|
-
tileCols: "Izgaradaki kolon sayısı (2–6)
|
|
1279
|
+
tileCols: "Izgaradaki kolon sayısı (2–6). Yalnız launcher düzeninde geçerlidir.",
|
|
1364
1280
|
tileStyle: "Karo görünümü: 'icon' yalın ikon + ad; 'card' zeminli, kenarlıklı kart. Yalnız launcher düzeninde geçerlidir.",
|
|
1365
1281
|
footerStyle: "'columns' her kök grup kendi kolonu olur ve çocukları altında listelenir; 'compact' her şey tek satıra dizilir. Yalnız footer düzeninde geçerlidir.",
|
|
1366
1282
|
footerDepth: "Kolonlarda gösterilecek seviye sayısı (1–9). Yalnız footerStyle columns iken anlamlı — sıkışık dizilişte tek seviye vardır.",
|
|
1367
1283
|
expandBehavior: "'multiple' birden çok dal aynı anda açık kalabilir; 'single' bir dal açılınca kardeşleri kapanır. Yalnız variant accordion/drawer iken — düz menüde her dal zaten açıktır.",
|
|
1368
|
-
defaultExpanded: "İlk yüklemede ne açık gelsin: 'active' aktif sayfaya giden dallar (drill panelleri ve alt drawer’lar dahil); 'all' hepsi; 'none' hiçbiri. Arama yapılırken bu ayar geçici olarak devre dışı kalır — eşleşen her dal açılır.
|
|
1284
|
+
defaultExpanded: "İlk yüklemede ne açık gelsin: 'active' aktif sayfaya giden dallar (drill panelleri ve alt drawer’lar dahil); 'all' hepsi; 'none' hiçbiri. Arama yapılırken bu ayar geçici olarak devre dışı kalır — eşleşen her dal açılır.",
|
|
1369
1285
|
groupCollapsible: "Kök GRUP başlıklarını da tıklanabilir yapar; ziyaretçi bütün bir grubu kapatabilir. Kapalıyken grup başlığı yalnız bir etikettir. Düz menüde anlamsızdır.",
|
|
1370
|
-
expandOnHover: "Fareyle üzerine gelince dalı açar. Yalnız KATMAN açan dallarda geçerlidir (flyout/cascade) — yerinde açılan ağaçta ve drill panelinde yok sayılır, pasif satırda da çalışmaz (navigation-nesting.ts shouldOpenOnHover).
|
|
1286
|
+
expandOnHover: "Fareyle üzerine gelince dalı açar. Yalnız KATMAN açan dallarda geçerlidir (flyout/cascade) — yerinde açılan ağaçta ve drill panelinde yok sayılır, pasif satırda da çalışmaz (navigation-nesting.ts shouldOpenOnHover). ≤768px’te otomatik kapanır.",
|
|
1371
1287
|
highlightParent: "Aktif sayfaya giden ÜST dalları da vurgular (kalın yazı + vurgu rengi ikon), böylece kapalı bir dalın içinde bulunduğun anlaşılır. Kapatılırsa yalnız yaprağın kendisi vurgulanır.",
|
|
1372
1288
|
animated: "Menünün hareketini açar/kapatır: dalın açılma kaydırması, chevron dönüşü ve satır renk geçişleri. Kapatıldığında ÜÇÜ birden durur. Ziyaretçinin işletim sistemi hareket azaltma tercihi (prefers-reduced-motion) bu proptan BAĞIMSIZ ve koşulsuz okunur — prop açık olsa da hareket çizilmez.",
|
|
1373
1289
|
showHeader: "Panelin üst bandı: marka (logo/ikon + title + subTitle), daraltma düğmesi ve drill başlığı buraya çizilir. Kapatılırsa menü doğrudan satırlarla başlar ve daraltma düğmesi alt kısma iner.",
|
|
@@ -1394,7 +1310,7 @@ export const componentKnowledge = {
|
|
|
1394
1310
|
dividers: "Kök GRUPLAR arasına ayraç çizgisi koyar. Grup içi satırları ayırmaz.",
|
|
1395
1311
|
iconSize: "Satır ikonunun boyutu (px, 12–32). Yalnız MENÜ ikonunu ölçekler; chevron, taşma oku ve dış bağlantı işareti yazıyla birlikte ölçeklenmeye devam eder. iconContainer \"tile\" ise ikon kutusu bu değerin 12px fazlasıdır.",
|
|
1396
1312
|
iconContainer: "İkonun zemini: 'none' yalın ikon; 'tile' her ikonun çevresine yuvarlak köşeli bir kutucuk; 'branch' kutucuk yalnız alt öğesi olan (modül) satırlarında, yapraklar yalın kalır. Kutucuk rail genişliğini de büyütür.",
|
|
1397
|
-
childIcons: "Alt seviye satırlarda da ikon gösterir. Kapalıyken ikon yalnız kök seviyede çizilir (rail hariç — orada her satır ikonuyla vardır). Sadece-metin modunda anlamsızdır.
|
|
1313
|
+
childIcons: "Alt seviye satırlarda da ikon gösterir. Kapalıyken ikon yalnız kök seviyede çizilir (rail hariç — orada her satır ikonuyla vardır). Sadece-metin modunda anlamsızdır.",
|
|
1398
1314
|
chevron: "Dalın açılır göstergesi: 'chevron' ok; 'caret' üçgen (açılınca DÖNER, ikon değişmez); 'plus' artı/eksi (yönsüz olduğu için durumu ikonun KENDİSİ söyler: kapalı '+', açık '−'). Düz menüde dal zaten açık olduğu için gösterge yoktur.",
|
|
1399
1315
|
chevronPosition: "Göstergenin satırdaki yeri: 'end' etiketin sonunda; 'start' ikondan önce. Yalnız YERİNDE açılan dallarda çizilir — katman/panel açan dal onun yerine alt öğe sayısını ve sağ oku gösterir.",
|
|
1400
1316
|
bgColor: "Menünün zemini. Boş bırakılırsa theme’in değeri geçerli kalır.",
|
|
@@ -1419,17 +1335,14 @@ export const componentKnowledge = {
|
|
|
1419
1335
|
summary: "Kompozisyon kabuğunun kökü: bölgeleri ve sayfa slot'unu içine dizersin. 2026-08-27'de eklendi, 2026-08-28'de EMEKLİYE AYRILMA kararı alındı — yeni layout'u container + slot ile kur (platform_guide('layout')). Kayıtlı kalır, mevcut layout'lar çalışmaya devam eder.",
|
|
1420
1336
|
behavior: [
|
|
1421
1337
|
"Gövdesi BLOK akışındadır ve çocukları 12 kolonluk IZGARA yerleştirir — hem runtime'da hem Studio tuvalinde. Gövde satır flex'i olsaydı renderer'ın çocuk sarmalayıcısı içerik genişliğine çökerdi (ölçüldü: runtime'da 1200px yerine 213px, tuvalde 0). Yani bölgelerin konumu dock prop'undan DEĞİL, blocks[]'ten gelir.",
|
|
1422
|
-
"
|
|
1423
|
-
"
|
|
1424
|
-
"sidebarOpen CANLI DURUMDUR: prop'un kendisi durumdur, toggle onu doğrudan yazar (qm-sidebar'ın isCollapsed deseni). Bir Durum değişkenine bağlanabilir ya da change-property akışıyla çevrilebilir. Mobil drawer'ın kapalı açılışı motora da yazılır (SHELL-005, 2026-09-29): ilk '!sidebarOpen' akışı artık çekmeceyi açar.",
|
|
1425
|
-
"toggle olayı DURUM DEĞİŞİKLİĞİNİ bildirir (SHELL-009, 2026-09-29): overlay, Escape, bir akışın ya da Durum bağlamasının yazdığı yeni değer aynı olayı doğurur; açılıştaki çözümleme olay sayılmaz. toggle'a bağlı bir akış sidebarOpen'ı çevirirse sonsuz döngü kurar — yapmayın.",
|
|
1426
|
-
"mobileBehavior yalnız yan panelin mobilde AÇIK BAŞLAYIP başlamayacağını belirler (resolveInitialSidebarOpen: drawer → kapalı, stack → açık). 2026-08-28'e kadar var olan 'stack ise gövdeyi column yap' CSS kuralı, gövde blok akışına geçtiği için KALDIRILDI — artık yerleşimi ızgara belirliyor.",
|
|
1338
|
+
"sidebarOpen CANLI DURUMDUR: prop'un kendisi durumdur, toggle onu doğrudan yazar (qm-sidebar'ın isCollapsed deseni). Bir Durum değişkenine bağlanabilir ya da change-property akışıyla çevrilebilir.",
|
|
1339
|
+
"mobileBehavior yalnız yan panelin dar ekranda AÇIK BAŞLAYIP başlamayacağını belirler (resolveInitialSidebarOpen: drawer → kapalı, stack → açık). 2026-08-28'e kadar var olan 'stack ise gövdeyi column yap' CSS kuralı, gövde blok akışına geçtiği için KALDIRILDI — artık yerleşimi ızgara belirliyor.",
|
|
1427
1340
|
"isViewportFilling / isShellRoot yetenekleri ve states.isShell bayrağı BACKEND'DE SAKLANMAZ (components tablosunda sütun yok, States kaydında isShell yok — zeyrek-frontend docs/issues.md BE-002). Davranışı tip adına düşen yedek listeler taşır; şema yazarken bu bayraklara güvenme."
|
|
1428
1341
|
],
|
|
1429
1342
|
propNotes: {
|
|
1430
|
-
surfaceStyle:
|
|
1343
|
+
surfaceStyle: NODE_SURFACE_NOTE,
|
|
1431
1344
|
sidebarOpen: 'Yan panelin açık olup olmadığı; canlı durumdur, bağlanabilir.',
|
|
1432
|
-
mobileBehavior: "'drawer' (varsayılan;
|
|
1345
|
+
mobileBehavior: "'drawer' (varsayılan; dar ekranda kapalı başlar) | 'stack' (dar ekranda açık başlar).",
|
|
1433
1346
|
style: "&__body ve &__overlay parçaları uygulanır."
|
|
1434
1347
|
}
|
|
1435
1348
|
},
|
|
@@ -1438,18 +1351,14 @@ export const componentKnowledge = {
|
|
|
1438
1351
|
behavior: [
|
|
1439
1352
|
"dock BÖLGENİN NEREDE DURDUĞUNU BELİRLEMEZ — biçimini ve yönünü belirler: left/right tam yükseklikte dikey kolon, top/bottom tam genişlikte yatay şerit, fill kenarlıklı/zeminli yüzey. Konum ve boyut, diğer her komponentteki gibi blocks[]'ten gelir.",
|
|
1440
1353
|
"Gövdesi container/shell ile aynı sebeple blok akışındadır; row yönündeki bir bölgede flex olsaydı içerik genişliğine çökerdi (üst şerit 8px kalırdı — ölçüldü).",
|
|
1441
|
-
"
|
|
1442
|
-
"isCollapsible:false 'bu bölge kapanmaz' demektir (REG-006, 2026-09-29): hem kendi isCollapsed'ini hem shell'in sidebarOpen'ını yok sayar. Tek istisna mobil drawer'dır — içeriğin üstüne binen panel kapanamazsa sayfayı örterdi.",
|
|
1443
|
-
"Shell içinde runtime'da açık bir yan panelin kolonları sabit pay alır (REG-001): bir yan panel kapanınca boşalan alanı fill ve şeritler alır, öbür yan panel genişlemez. Gizli bir şeridin satırları da çöker (REG-005).",
|
|
1444
|
-
"top/bottom şeridi ızgaradaki alanının tam yüksekliğini alır (REG-004, 2026-09-29; önce içeriği kadar çiziliyordu).",
|
|
1445
|
-
"MOBİLDE SIRA DOCK'TAN GELİR (REG-003, 2026-09-29): shell içinde ≤767px'te bölgeler top → left → fill (ve bölge olmayan çocuklar) → right → bottom sırasıyla dizilir; dockMobile:'bottom' seçilen bölge gerçekten en alta iner. Tuvalde tasarımcının sırası görünür.",
|
|
1354
|
+
"Kenara yaslı bölge (dock !== 'fill') shell'in sidebarOpen'ını izler ve kapanır; fill ASLA gizlenmez — yoksa sayfa içeriği kaybolurdu. Shell dışında tek başına duran bölge her zaman açık kabul edilir.",
|
|
1446
1355
|
"appearance.hideOn, dockMobile'ı HER ZAMAN yener; dockMobile:'hidden' yalnız bölge-yerel kısayoldur."
|
|
1447
1356
|
],
|
|
1448
1357
|
propNotes: {
|
|
1449
|
-
surfaceStyle:
|
|
1450
|
-
dock: "left | right | top | bottom | fill — biçim/yön
|
|
1358
|
+
surfaceStyle: NODE_SURFACE_NOTE,
|
|
1359
|
+
dock: "left | right | top | bottom | fill — biçim/yön, konum değil.",
|
|
1451
1360
|
dockMobile: "inherit (varsayılan; masaüstünü izler) | left | right | top | bottom | drawer (içeriğin üstüne biner) | hidden.",
|
|
1452
|
-
isCollapsible:
|
|
1361
|
+
isCollapsible: 'Bölgenin kapanabilir olup olmadığı.',
|
|
1453
1362
|
isCollapsed: 'Kapalı başlar; bir Durum değişkenine bağlanabilir.',
|
|
1454
1363
|
style: '&__body parçası uygulanır.'
|
|
1455
1364
|
}
|
|
@@ -1611,9 +1520,7 @@ export const componentKnowledge = {
|
|
|
1611
1520
|
summary: 'Kalın sayfa başlığı + önünde daralan kırıntı izi; eski mustache "doküman başlık" HTML widget’ının komponent karşılığı. KAPSAYICI DEĞİLDİR, çocuk almaz.',
|
|
1612
1521
|
behavior: [
|
|
1613
1522
|
"Son maxVisibleItems öğe satır içinde kalır, öncekiler '…' menüsüne toplanır (varsayılan 1; 0 = izin tamamı menüde). Daralma SAYIYLA olur, genişlikle değil — dar düğümde satır içi öğeler kısalıp üç nokta ile biter.",
|
|
1614
|
-
"Öğeye tıklamak önce öğenin KENDİ flow'unu çalıştırır, sonra clickItem yayar (dropdown-button sözleşmesi).
|
|
1615
|
-
"ERİŞİLEBİLİRLİK (2026-09-30, BT-001/003/004): kök bir nav'dır (sözlükten 'Gezinti yolu' / 'Breadcrumb'; gösterecek bir şey yoksa etiketsiz div), başlık aria-current='page' taşır. Kök ikon düğmesinin adı 'Ana sayfa' / 'Home', '…' düğmesininki 'Diğer seviyeler' / 'More levels' (aria-haspopup='menu' + aria-expanded); ikonlar ve ayraçlar ekran okuyucudan gizlidir. Açık '…' menüsü Escape ile kapanır, odak düğmeye döner.",
|
|
1616
|
-
"DAR DÜĞÜM (BT-005): satır içi öğeler ÖNCE küçülür (üç noktaya kadar), başlık ancak sonra — 469px'lik düğümde 649px'lik başlığın 302px'i okunur (önce 205px). Kök ikon + ayraçlar sabit yer kaplar; 250px altındaki düğümde başlık yine dar kalır, orada maxVisibleItems'ı düşür.",
|
|
1523
|
+
"Öğeye tıklamak önce öğenin KENDİ flow'unu çalıştırır, sonra clickItem yayar (dropdown-button sözleşmesi). Tıklanan öğe düğümün currentItem prop'una yazılır: akış self.currentItem.key ile hangi adımın seçildiğini okur.",
|
|
1617
1524
|
'rootHref verilmişse kök ikonu ona gider ve rootFlow ÇALIŞMAZ — href akışı ezer; clickRoot ise HER durumda yayılır (2026-09-17: href yazılıyken sessizce yutuluyordu). Dış adres (http, https, mailto, tel) tam sayfa gezinmesiyle açılır, uygulama içi yol router ile.',
|
|
1618
1525
|
'isLoading açıkken iz ve başlık yerine iskelet çubukları çizilir; o sırada tıklanacak öğe yoktur. Veriyi mount olayına bağlanan akış getiriyorsa bunu aç, satır boy değiştirmesin.'
|
|
1619
1526
|
],
|
|
@@ -1622,12 +1529,7 @@ export const componentKnowledge = {
|
|
|
1622
1529
|
maxVisibleItems: 'Satır içinde kalacak öğe sayısı (varsayılan 1).',
|
|
1623
1530
|
rootIcon: 'Kök (ana sayfa) ikonu; NESNE bekler: { name: home }. Üretilen şema tipi string der ama runtime name alanını okur — düz metin de kabul edilir, runtime onu nesneye çevirir. Boş bırakılırsa kök düğmesi hiç çizilmez ve rootHref/rootFlow ulaşılamaz kalır.',
|
|
1624
1531
|
title: 'Sayfa başlığı; izin EN SAĞINDA, kalın. Şema varsayılanı Page title ve runtime da aynı varsayılanı çizer (CQ-265). Boş bırakılırsa yalnız iz görünür.',
|
|
1625
|
-
isLoading: 'İçerik yerine iskelet çizer (iz çubuğu + başlık çubuğu
|
|
1626
|
-
rootHref: "Kök ikonunun adresi (bağlantı seçici: sayfa ya da özel adres). Doluysa rootFlow ÇALIŞMAZ; önce clickRoot yayılır, sonra gezinilir — dış adres (http/https/mailto/tel) tam sayfa, uygulama içi yol router ile. rootIcon boşsa kök düğmesi hiç çizilmez ve bu prop etkisizdir.",
|
|
1627
|
-
rootFlow: "Kök ikonuna basınca koşan akış; YALNIZ rootHref boşken çalışır. Akış veri almaz (event.data boştur). clickRoot olayı bundan bağımsız ve her basışta yayılır.",
|
|
1628
|
-
style: "Serbest CSS, KÖK satıra uygulanır (zemin, dolgu, kenarlık …). Şema iç parça (&__title gibi) BİLDİRMEZ: başlık, öğe ve ayraç stilleri bileşenin kendi kurallarıdır, parça sözleşmesiyle değiştirilemez.",
|
|
1629
|
-
isHidden: 'Düğümü hiç çizmez (ortak katman). Öğe bazlı gizleme items[].isHidden’dır.',
|
|
1630
|
-
currentItem: "Şemada GİZLİ durum prop'u (panelde çizilmez): clickItem tıklanan öğeyi buraya yazar. Akış öğeyi event.data.currentItem ile okusun; kendin yazman gerekmez."
|
|
1532
|
+
isLoading: 'İçerik yerine iskelet çizer (iz çubuğu + başlık çubuğu). Akış izi yazana kadar açık tutulur.'
|
|
1631
1533
|
}
|
|
1632
1534
|
},
|
|
1633
1535
|
carousel: {
|
|
@@ -1677,6 +1579,8 @@ export const componentKnowledge = {
|
|
|
1677
1579
|
'aggregate/sort/topN/nullMode veriyi çizimden ÖNCE dönüştürür — aynı işi akışta yapmana gerek yok.',
|
|
1678
1580
|
'isDrillDown:true iken veri noktasına tıklamak kırıntı seviyesi ekler; dataPointClick yükü kaynak satırın TAMAMINI (row) taşır, böylece alt seviye sorgusu tek olayla kurulur. Geri dönüş breadcrumbClick ile bildirilir ve yeniden sorgulamak akışın işidir.',
|
|
1679
1581
|
'isExportable "tablo olarak gör" + dışa aktarma araç çubuğunu açar; showRefresh refresh olayını yayan bir yenile düğmesi ekler.',
|
|
1582
|
+
"OLAYLAR (2026-09-25 düzeltmesi): nokta tıklaması YALNIZ dataPointClick, kategori ekseninin etiketine basış YALNIZ axisLabelClick yayar (yatay çubukta etiketler y eksenindedir). Öncesinde axisLabelClick her nokta tıklamasında noktanın değeriyle geliyor, etikete basış ise hiç gelmiyordu: triggerEvent eksen yerine axisLabel altındaydı ve olay sorgusu nesne olduğu için süzmüyordu. Hedef çizgisi, bant ve eksen başlığı tıklaması olay değildir; selectionChange yalnız selectionMode açıkken gelir (kapalıyken ECharts'ın boş seçimi self.selected'ı eziyordu); dataPointClick.row kategori adıyla bulunur (nullMode skip sonrası kayan dataIndex yanlış satırı veriyordu). Eşleme mobil chart ile ortak (chart-events.ts).",
|
|
1583
|
+
'BOZUK BAĞLI VERİ (2026-09-25): series/rows beklenmedik şekilde gelirse (dizi yerine metin, okunamayan alan) grafik düşmez — veri çözülemezse emptyText, seçenek kurulamazsa önceki çizim kalır. Eksen başlığı (categoryAxis.title / valueAxis.title) eksenin ortasına, etiketlerin dışına yazılır; ızgara etiket + başlığa yer ayırır (2026-09-29). title/subtitle doluyken çizim alanı başlığın altına iner (radar/radyalde merkez aşağı kayar).',
|
|
1680
1584
|
"PASTA/HALKA ETİKETİ (2026-08-27 düzeltmesi): dataLabels.show artık pie/donut'a da geçiyor. Öncesinde prop bu dala hiç ulaşmıyordu ve dilim etiketleri HİÇBİR ayarla kapatılamıyordu — çekme çizgileri legend'in üstüne bindiği için halka fiilen kullanılamıyordu. Temiz halka için dataLabels:{ show:false } yaz.",
|
|
1681
1585
|
'LEGENDDEN SERİ GİZLEME ÇALIŞIYOR (2026-09-16 düzeltmesi): legend tıklaması artık kalıcı. Öncesinde tıklama ~8 ms sonra kendiliğinden geri alınıyordu — olay yükü prop’lara yazılıyor, tepkime notMerge çizim yapıyor ve ECharts’ın legend.selected durumu siliniyordu. Seçim çizimden önce option’a geri yazılıyor; listede olmayan seri adları elenir.',
|
|
1682
1586
|
'YATAY + İKİNCİL EKSEN ÇİZİLİYOR (2026-09-16 düzeltmesi): orientation:"horizontal" ile bir seride axis:"secondary" birlikte verilince grafik SESSİZCE boş çiziliyordu — yatayda değer eksenleri xAxis dizisindedir, yAxis tek kategori eksenidir. Kombo grafiği artık iki yönelimde de kurulabilir.',
|
|
@@ -1697,7 +1601,7 @@ export const componentKnowledge = {
|
|
|
1697
1601
|
subtitle: 'Başlığın altına yazılır. Başlık boş bırakılsa da çizilir (2026-09-16 öncesinde title boşken subtitle kayboluyordu).',
|
|
1698
1602
|
chartType: "bar | line | area | pie | donut | waterfall | histogram | pareto | bullet | tornado | radial | funnel | gauge | radar | funnelflow | scatter. SEÇİLEN TİP hangi ayarların OKUNDUĞUNU belirler; panel de ona göre gizler.",
|
|
1699
1603
|
sizeField: 'YALNIZ scatter: nokta çapını ölçekleyen sayısal kolon (kabarcık grafiği). Boş bırakılırsa bütün noktalar aynı boyda çizilir.',
|
|
1700
|
-
barStyle: '{ barWidth, maxBarWidth, barGap, categoryGap, borderRadius, minBarSize } — YALNIZ bar ve tornado okur. minBarSize çok küçük değerlerin görünmez kalmasını engeller (ECharts barMinHeight); 2026-09-16 öncesinde şemada duruyor ama hiçbir yerde okunmuyordu.
|
|
1604
|
+
barStyle: '{ barWidth, maxBarWidth, barGap, categoryGap, borderRadius, minBarSize } — YALNIZ bar ve tornado okur. minBarSize çok küçük değerlerin görünmez kalmasını engeller (ECharts barMinHeight); 2026-09-16 öncesinde şemada duruyor ama hiçbir yerde okunmuyordu.',
|
|
1701
1605
|
categoryAxis: '{ title, isReversed, labelRotate, gridLines }. Kategori ekseni HER ZAMAN kategori eksenidir; bir zaman ekseni anahtarı vardı, çizilemeyen bir option ürettiği için 2026-09-16’da kaldırıldı. scatter’da bu prop x (değer) eksenini ayarlar.',
|
|
1702
1606
|
colorRules: '[{ operator, value, valueTo, color }] — ilk eşleşen kural kazanır. radial/funnel/radar/funnelflow dışındaki her tipte uygulanır.'
|
|
1703
1607
|
}
|
|
@@ -1728,7 +1632,7 @@ export const componentKnowledge = {
|
|
|
1728
1632
|
emptystate: {
|
|
1729
1633
|
summary: 'Boş ekran/liste bloğu: görsel ya da ikon + başlık + açıklama + aksiyon düğmeleri. Olayları mount ve actionClick.',
|
|
1730
1634
|
behavior: [
|
|
1731
|
-
"
|
|
1635
|
+
"actions[].flow doğrudan çalışır (emit'in flowId'si üzerinden) ve ayrıca actionClick yayılır — table'ın boş durum aksiyonlarıyla aynı sözleşme.",
|
|
1732
1636
|
'image verilirse icon ÇİZİLMEZ (görsel ikonu ezer); ikisi birden gösterilmez.',
|
|
1733
1637
|
'isDisabled aksiyon tıklamayı yutar: ne kendi flow’u çalışır ne actionClick yayılır.',
|
|
1734
1638
|
'actions[].href verilen düğme gerçek bir <a> olur (orta tuş/yeni sekme çalışır); href ile flow birlikte verilebilir, tıklamada ikisi de işler. isDisabled olan satır href almaz, aria-disabled alır.',
|
|
@@ -1737,16 +1641,11 @@ export const componentKnowledge = {
|
|
|
1737
1641
|
'Her parça isteğe bağlıdır; yalnız title taşıyan bir blok geçerlidir. Icon ve görsel ekran okuyucuya dekoratiftir, mesajı h3 olan title taşır.'
|
|
1738
1642
|
],
|
|
1739
1643
|
propNotes: {
|
|
1740
|
-
image: 'Drive dosyası ya da URL; verildiğinde icon yok sayılır.
|
|
1741
|
-
|
|
1742
|
-
description: 'Başlığın altındaki açıklama; en çok 420px genişler, uzun metin ve boşluksuz kelime kırılır. Boşsa çizilmez; sayı metindir.',
|
|
1743
|
-
isHidden: 'Ortak katman görünürlüğü: true iken blok DOM’a girmez; mount, blok ilk kez görünür olduğunda yayılır.',
|
|
1744
|
-
customIconColor: "Yalnız iconColor 'custom' iken okunur (panelde de o koşulla görünür); hex/rgb ya da tema token'ı. Boş ya da geçersizse primary tonuna düşer.",
|
|
1745
|
-
style: "Köke uygulanır. Parçalar: '&__icon', '&__image', '&__title', '&__description', '&__actions'.",
|
|
1746
|
-
size: 'sm | md (varsayılan) | lg — ikon/görsel ölçüsünü ve dikey boşluğu birlikte ölçekler (dar kartta sm): ikon 40 / 64 / 88px (2026-10-01, QA ES-001; öncesinde ikon her boyutta 20px kalıyordu).',
|
|
1644
|
+
image: 'Drive dosyası ya da URL; verildiğinde icon yok sayılır.',
|
|
1645
|
+
size: 'sm | md | lg — ikon/görsel ölçüsünü ve dikey boşluğu birlikte ölçekler (dar kartta sm).',
|
|
1747
1646
|
align: 'left | center | right — metin, ikon ve düğmeler birlikte hizalanır.',
|
|
1748
|
-
icon:
|
|
1749
|
-
iconColor:
|
|
1647
|
+
icon: 'Yalnız ikon ADI okunur; glif rengi iconColor + customIconColor ile verilir (picker’ın gömülü renk alanı kapalı).',
|
|
1648
|
+
iconColor: 'Boş bırakılırsa ikon sönük gri kalır — boş durum genelde bir hata değildir. custom seçilirse renk customIconColor’dan gelir.',
|
|
1750
1649
|
isLoading: 'Akış veriyi getirene kadar iskelet. Bileşen geri yazmaz, yalnız akış sürer.',
|
|
1751
1650
|
actions: '[{ text, icon, kind, variant, flow, href, isNewTabLink, isHidden, isDisabled }] — boş bırakılan alanlar hiç çizilmez. isNewTabLink yalnız href dolu satırda anlamlıdır (panelde de o koşulla görünür) ve bağlantıyı target="_blank" + rel="noreferrer noopener" ile yeni sekmede açar; sayfa yerinde kaldığı için actionClick’in sonucu da görünür kalır. isHidden satır hiç çizilmez ve actionClick’in index’inde SAYILMAZ.'
|
|
1752
1651
|
}
|
|
@@ -1878,31 +1777,19 @@ export const componentKnowledge = {
|
|
|
1878
1777
|
progress: {
|
|
1879
1778
|
summary: 'Çubuk ya da daire biçiminde ilerleme göstergesi; eşiğe göre renk değiştirir. label neyin ilerlediğini yazar, showLabel değer okumasını açar.',
|
|
1880
1779
|
behavior: [
|
|
1881
|
-
"complete yalnız yüzde 100'e İLK ULAŞTIĞINDA (kenar tetiklemesi) bir kez yayılır — her render'da değil; değer 100'ün altına inip yeniden çıkarsa tekrar yayılır. isIndeterminate:true iken hiç yayılmaz (belirsiz modda 'tamamlanma' tanımsızdır).
|
|
1780
|
+
"complete yalnız yüzde 100'e İLK ULAŞTIĞINDA (kenar tetiklemesi) bir kez yayılır — her render'da değil; değer 100'ün altına inip yeniden çıkarsa tekrar yayılır. isIndeterminate:true iken hiç yayılmaz (belirsiz modda 'tamamlanma' tanımsızdır).",
|
|
1882
1781
|
'click yalnız akış BAĞLIYSA çalışır: bağlıyken sarmalayıcı <button> olur ve odak sırasına girer, bağlı değilken düz <div> kalır (badge/avatar/icon/image/video/statcard ile aynı desen). role="progressbar" içteki elemanda kalır.',
|
|
1883
1782
|
'max alanı TEMİZLENİRSE 100 sayılır (şema varsayılanı), 0 değil — boş sayı alanı panelde null olarak saklanır ve 0 gibi okunsaydı bar tamamen boşalırdı. Prop .min(1) olduğu için kaybedilen bir "0" hâli yoktur.'
|
|
1884
1783
|
],
|
|
1885
1784
|
propNotes: {
|
|
1886
1785
|
label: 'Neyin ilerlediğini söyleyen metin ("Uploading…"); barın/dairenin ÜSTÜNDE durur. Değer okuması DEĞİLDİR — o showLabel/labelFormat/labelPosition üçlüsüdür. isIndeterminate:true iken de görünür; belirsiz kipte ekrandaki tek bilgi budur.',
|
|
1887
|
-
value:
|
|
1888
|
-
max: 'Yüzdenin paydası (varsayılan 100, en az 1). Temizlenirse 100 sayılır.',
|
|
1889
|
-
labelFormat: 'Değer okumasının biçimi: percent (40%) · fraction (3/10) · value (3). Yalnız showLabel açıkken çizilir; ekran okuyucuya aria-valuetext olarak da verilir.',
|
|
1890
|
-
showTrack: 'Dolgunun arkasındaki izi çizer (varsayılan true). Kapalıyken çubukta iz saydam olur, dairede iz çemberi hiç çizilmez.',
|
|
1891
|
-
isHidden: 'Ortak katman görünürlüğü: true iken gösterge DOM’a girmez.',
|
|
1892
|
-
variant: 'bar (varsayılan) | circle. Dairede okuma ortadadır; labelPosition ve isStriped okunmaz. Daire çapı size ile değişir: 56 / 84 / 112px.',
|
|
1893
|
-
size: 'sm | md (varsayılan) | lg — çubuk yüksekliği 5 / 8 / 12px, daire çapı 56 / 84 / 112px. thickness yazılırsa çubuk yüksekliğini o belirler.',
|
|
1894
|
-
color: "Dolgunun rengi: primary (varsayılan) | info | success | warning | error | custom. Eşik (thresholds) tutarsa onu ezer. info bu bileşende ikincil metin rengiyle (--ng-text-secondary) boyanır: temanın info tonu iz rengiyle aynı açıklıktadır ve çubuk boş görünüyordu (2026-10-01, QA PG-001). warning temanın sarısında kalır; okuma içerideyken sarı dolguda koyu yazılır (QA PG-004).",
|
|
1895
|
-
customColor: 'Yalnız color custom iken okunur (panelde de o koşulla görünür); boş ya da geçersizse primary tonuna düşer. Bir eşik rengi ezdiğinde okunmaz.',
|
|
1896
|
-
trackColor: 'İzin rengi; boşsa tema yüzey tonu. custom seçilirse customTrackColor okunur. showTrack kapalıyken okunmaz ve panelde gizlenir.',
|
|
1897
|
-
customTrackColor: 'Yalnız trackColor custom iken okunur.',
|
|
1898
|
-
style: "Köke uygulanır. Parçalar: '&__caption' (label), '&__track' (iz), '&__fill' (dolgu), '&__label' (değer okuması).",
|
|
1899
|
-
isIndeterminate: 'Belirsiz kip: çubukta kayan dolgu, dairede dönen yay. value/max/thresholds ve değer okuması okunmaz (panelde de gizlenir), complete yayılmaz; label görünmeye devam eder.',
|
|
1786
|
+
value: '0..max arası; yüzde kırpılarak hesaplanır.',
|
|
1900
1787
|
showLabel: 'DEĞER okumasını açar (40% · 3/10 · 40) — label prop’unu değil. Panel başlığı "Show value".',
|
|
1901
1788
|
thresholds: '[{ from: <yüzde>, color: <primary|info|success|warning|error> }] — yüzdeye eşit/altındaki EN BÜYÜK eşiğin rengi kazanır, hiçbiri tutmazsa color prop’u. from BOŞ bırakılan satır düşer; açık 0 geçerlidir. isIndeterminate:true iken eşikler devre dışıdır.',
|
|
1902
1789
|
colorMap: '{ "0": "error", "50": "warning", "80": "success" } — thresholds’un ESKİ biçimi, panelde gizli, yalnız thresholds boşken okunur. Yeni iş thresholds yazar.',
|
|
1903
1790
|
thickness: 'Piksel. Barda yükseklik, dairede çizgi kalınlığı — daire için ölçülen çaptan çizim birimine çevrilir ve yay kırpılmasın diye sınırlanır, yani çok büyük değerler sessizce tavana oturur. Boş/0 = Size’dan gelen kalınlık.',
|
|
1904
1791
|
isStriped: 'Yalnız barda; dairede stroke üzerinde görünmez.',
|
|
1905
|
-
labelPosition: 'DEĞER okumasının yeri
|
|
1792
|
+
labelPosition: 'DEĞER okumasının yeri (bar içinde / yanında). Dairede etiket zaten ortadadır, ayar gizlenir.'
|
|
1906
1793
|
}
|
|
1907
1794
|
},
|
|
1908
1795
|
rating: {
|
|
@@ -1920,22 +1807,18 @@ export const componentKnowledge = {
|
|
|
1920
1807
|
result: {
|
|
1921
1808
|
summary: 'Durum bloğu (success/error/warning/info): büyük ikon ya da illüstrasyon + başlık + alt başlık + aksiyonlar — işlem sonucu ekranları için. KAPSAYICI DEĞİLDİR, çocuk komponent almaz.',
|
|
1922
1809
|
behavior: [
|
|
1923
|
-
|
|
1810
|
+
'actions[].flow doğrudan çalışır ve actionClick yayılır (emptystate ile aynı sözleşme).',
|
|
1924
1811
|
'Renk ve varsayılan ikon status prop’undan gelir; icon prop’u yalnız GLİFİ ezer, rengi ezmez — bu komponentte renk anlamın kendisidir (başarı yeşil, hata kırmızı).',
|
|
1925
1812
|
'Görsel slotu hiç boş kalmaz: image doluyken ikon çizilmez, ama adres yüklenemezse durum ikonuna geri dönülür.',
|
|
1926
1813
|
'isLoading açıkken durum ikonu ve metinler ÇİZİLMEZ — yerine nötr bir çark ve iskelet çubuklar gelir ve hiçbir olay yayılmaz. Sebep: varsayılan başlık ile yeşil onay, akış daha cevap vermeden "işlem tamam" derdi. İskelet gerçek yerleşimi taklit eder (yazılı her metin için bir çubuk, görünen her aksiyon için bir şerit; boy ölçüsü size ile ölçeklenir), yani veri gelince blok zıplamaz. Sonucu bir akıştan dolduruyorsan düğümü isLoading açık bırak, akışın son adımı kapatsın.',
|
|
1927
1814
|
'mount ortak katmandan gelir ve sayfa açılınca bir kez yayılır; sonucu dolduran akışın kancası budur.'
|
|
1928
1815
|
],
|
|
1929
1816
|
propNotes: {
|
|
1930
|
-
icon:
|
|
1931
|
-
title: "Başlık (h2). Yazılmazsa ÇİZİLMEZ: 'Operation completed' yalnız Studio'da bırakılan bloğun örneğidir (2026-10-01, QA RS-006). Sayı da metindir (0 çizilir). Boşluksuz uzun kelime blok içinde kırılır.",
|
|
1932
|
-
subtitle: 'Başlığın altındaki açıklama; en çok 480px genişler, uzun metin ve boşluksuz kelime kırılır. Boşsa çizilmez; sayı metindir.',
|
|
1933
|
-
isHidden: 'Ortak katman görünürlüğü: true iken blok DOM’a girmez, mount da yayılmaz.',
|
|
1934
|
-
style: "Köke uygulanır. Parçalar: '&__icon' (ikon çipi), '&__image', '&__title', '&__subtitle', '&__actions'.",
|
|
1817
|
+
icon: 'Durum ikonunu ezer, RENGİ ezmez (renk her zaman status’tan gelir). Picker’ın gömülü renk alanı bu yüzden kapalıdır — yazılsa okunmazdı.',
|
|
1935
1818
|
image: 'İllüstrasyon (Drive dosyası ya da mutlak URL). Doluyken ikon hiç çizilmez ve panelde gizlenir; adres çözülemezse durum ikonuna geri dönülür.',
|
|
1936
1819
|
status: 'Hem rengi hem varsayılan ikonu belirler; tanınmayan/boş değer info okunur.',
|
|
1937
1820
|
align: 'İçeriğin yatay hizası: metin, ikon ve düğmeler birlikte döner.',
|
|
1938
|
-
size: '
|
|
1821
|
+
size: 'Dolguyu, ikon çipini ve başlığın puntosunu birlikte ölçekler.',
|
|
1939
1822
|
actions: 'Düğme listesi. Her satır flow (akış tetikler) ya da href (gezinme) alabilir, ikisi birlikte de çalışır. href dolu satır gerçek bir bağlantı olur (orta tuşla yeni sekme); isNewTabLink açıkken düğme zaten yeni sekmede açılır. isDisabled satırın bağlantısını düşürür ve tıklamayı yaymaz. isHidden satır hiç çizilmez ve actionClick’in index’inde de SAYILMAZ.',
|
|
1940
1823
|
isLoading: 'Sonuç henüz belli değilken açılır: blok iskelete döner, actionClick yayılmaz. Akışın kendisi kapatmalı — kendiliğinden kapanmaz.'
|
|
1941
1824
|
}
|
|
@@ -2057,43 +1940,29 @@ export const componentKnowledge = {
|
|
|
2057
1940
|
}
|
|
2058
1941
|
},
|
|
2059
1942
|
toast: {
|
|
2060
|
-
summary: 'Geçici bildirim TETİKLEYİCİSİ:
|
|
1943
|
+
summary: 'Geçici bildirim TETİKLEYİCİSİ: sayfada yer kaplamaz (0×0), isOpen true’ya çekildiğinde bir toast atar.',
|
|
2061
1944
|
behavior: [
|
|
2062
1945
|
"Tetikleme isOpen'ın YÜKSELEN KENARIDIR: komponent toast'ı gösterdikten sonra isOpen'ı kendi prop'unda false'a geri yazar. Akışta setter ile true yaz, sıfırlamayı düşünme.",
|
|
2063
1946
|
'Süre kind’a göre gelir (success/info/default 4sn, warning 6sn, error 8sn, loading süresiz); duration verirsen o kazanır, isSticky ise kapanmaz.',
|
|
2064
|
-
"
|
|
2065
|
-
"Başlığı da içeriği de boş olan toast ATILMAZ (2026-10-01, QA TS-008): kart çıkmaz, open/close koşmaz, isOpen yine false'a döner. content yazılmamış düğüm boş sayılır — 'Toast content goes here' yalnız Studio'da bırakma anının örneğidir.",
|
|
2066
|
-
"Farklı konumlara atılan toast'lar 480px altında kenar başına tek sütunda birleşir (üstte: top-full bandı, sonra üst köşeler; altta: center, alt köşeler, sonra bottom-full bandı); geniş ekranda bant aynı kenardaki köşe yığınlarını kendi yüksekliği kadar iter (2026-10-01, QA TS-003; öncesinde yığınlar birbirini örtüyordu).",
|
|
1947
|
+
"actions[].flow doğrudan çalışır ve actionClick yayılır; keepOpen verilmedikçe tıklama toast'ı kapatır. En çok 2 düğme çizilir, fazlası sessizce atılır.",
|
|
2067
1948
|
'Toast alanını runtime her uygulamada bir kez kurar — ikinci bir toast komponenti eklemek bildirimleri ÇİFTLEMEZ, her tetikleyici kendi toast’ını atar.',
|
|
2068
1949
|
"Aynı bildirimin üst üste binmesini duplicates kapatır: ignore aynı anahtarlı toast dururken yenisini ATAR, count tek kart üstünde ×N sayıp süreyi yeniler; varsayılan allow her tetiklemede yeni kart yığar — çift tıklanan Kaydet düğmesinin çözümü budur. ATILAN tetikleme HİÇBİR olay yaymaz: o toast için open, close ve click koşmaz, yani close akışına bağladığın iş ikinci tıklamada çalışmaz.",
|
|
2069
1950
|
"Aynılık sayfadaki TÜM toast'lar arasında bakılır (anahtar dedupeKey, yazmazsan kind + title + content): iki ayrı toast düğümü aynı metni taşıyorsa biri ötekini bastırır — varsayılan içeriği bırakmak bunu kolaylaştırır, o yüzden ignore ya da count seçtiğinde dedupeKey yaz. Kuyrukta bekleyen toast da eşleşir, delay ile beklemekte olan eşleşmez.",
|
|
2070
|
-
"open olayı toast KUYRUĞA girdiğinde yayılır: delay beklenir, duplicates ile atılan ya da do-not-disturb ile bastırılan toast open yaymaz, ama aynı konumda 5 toast doluysa fazlası ekranda görünmeden de open yayar. close yükünde reason taşır ve akışta
|
|
1951
|
+
"open olayı toast KUYRUĞA girdiğinde yayılır: delay beklenir, duplicates ile atılan ya da do-not-disturb ile bastırılan toast open yaymaz, ama aynı konumda 5 toast doluysa fazlası ekranda görünmeden de open yayar. close yükünde reason taşır ve akışta self.reason ile okunur: timeout süre doldu, user kullanıcı kapattı (× düğmesi, closeOnClick tıklaması, kaydırma, Escape, aksiyon düğmesi, Clear all), programmatic koddan kapatıldı. Gecikmede bekleyen toast iptal edilirse close HİÇ yayılmaz."
|
|
2071
1952
|
],
|
|
2072
1953
|
propNotes: {
|
|
2073
|
-
isOpen: 'Setter ile true yaz → bir toast; komponent false’a geri döner.
|
|
1954
|
+
isOpen: 'Setter ile true yaz → bir toast; komponent false’a geri döner.',
|
|
2074
1955
|
kind: 'default | info | success | error | warning | loading.',
|
|
2075
1956
|
position: '9 çapa: top/bottom × left/center/right, center, top-full/bottom-full (tam genişlik bant).',
|
|
2076
1957
|
actions: '[{ text, flow, keepOpen, showCountdown }] — en çok 2 düğme.',
|
|
2077
1958
|
dedupeKey: "Aynılık ölçütü; yazılmazsa kind + title + content’ten türer ve sayfadaki bütün toast'ları kapsar. Tek başına hiçbir şey yapmaz, duplicates ile çalışır.",
|
|
2078
1959
|
duplicates: 'allow (varsayılan, her tetikleme yeni toast) · ignore (aynı anahtarlı toast dururken yeni tetikleme atılır, olayları da koşmaz) · count (tek kart üstünde ×N sayacı, süre yenilenir). Şemada allow bırakmak ayarlamamakla aynıdır: uygulama koddan başka bir strateji kurduysa o geçerli olur.',
|
|
2079
|
-
icon: "
|
|
1960
|
+
icon: "Yazılmazsan türün ikonu çizilir; boş metin (\"\") verirsen hiç ikon çizilmez. kind loading iken ikon hiç okunmaz, yerine dönen halka çizilir.",
|
|
2080
1961
|
duration: 'ms; 0 ya da boş = türün varsayılan süresi. Hiç kapanmaması için isSticky.',
|
|
2081
1962
|
priority: "Yalnız aynı konumda 5 toast dolduğunda sıra değiştirir (yüksek olan öne geçer); normal bir ekranda gözle görülür etkisi YOKTUR.",
|
|
2082
1963
|
showProgress: "Yalnız süreli toast'ta çizilir: isSticky ya da kind loading iken ilerleme çubuğu zaten yok.",
|
|
2083
1964
|
pauseOnHover: "Yalnız süreli toast'ta anlamlı: duraklatılacak bir sayaç yoksa (isSticky, loading) etkisizdir.",
|
|
2084
|
-
isHidden: 'Açıkken komponent hiç kurulmaz: toast ATILMAZ. Gizli bir tetikleyici değil, kapalı bir tetikleyicidir — isOpen true yazmak da bir şey göstermez.'
|
|
2085
|
-
title: 'Kalın başlık satırı; uzun başlık kırılır, taşmaz. Boş bırakılabilir — ama title da content de boşsa toast atılmaz.',
|
|
2086
|
-
content: "Bildirim metni. Yazılmazsa BOŞTUR ('Toast content goes here' yalnız Studio'da bırakma anının örneğidir). Uzun metin ve boşluksuz uzun kelime kart içinde kırılır.",
|
|
2087
|
-
isSticky: 'true iken toast kendiliğinden kapanmaz ve ilerleme çubuğu çizilmez; duration yok sayılır (panelde de gizlenir).',
|
|
2088
|
-
showCloseButton: "Varsayılan true. Kapatılırsa × çizilmez; toast yine süreyle, closeOnClick'le, aksiyonla ya da odaktayken Escape ile kapanır. isSticky + showCloseButton false + aksiyonsuz bir toast fareyle kapatılamaz — birini açık bırakın.",
|
|
2089
|
-
closeOnClick: "true iken karta tıklamak click olayını yayar VE toast'ı kapatır (close, reason 'user'). false iken yalnız click yayılır. × düğmesi click yaymaz.",
|
|
2090
|
-
showCopyButton: 'Kartta kopyala düğmesi çizer: başlık + içerik panoya gider (başlık varsa ilk satırda).',
|
|
2091
|
-
allowHtml: "true iken content HTML olarak çizilir ama sıkı temizlenir: kalın/italik gibi satır içi biçim ve http(s)/mailto bağlantıları kalır (bağlantılar yeni sekmede, rel=noopener), <script>, <img>, olay öznitelikleri atılır. false iken (varsayılan) HTML düz metin olarak görünür.",
|
|
2092
|
-
delay: 'ms; toast bu kadar bekledikten sonra çıkar, open olayı da o zaman yayılır. Boş = hemen.',
|
|
2093
|
-
maxLines: 'İçeriği bu satır sayısında kırpar ve altına aç/kapa bağlantısı koyar (metni uygulama diline çevrilir). Boş = sınırsız.',
|
|
2094
|
-
variant: "soft (varsayılan, açık renkli zemin) · filled (koyu, dolu zemin, açık metin — kontrast AA: 2026-10-01'den beri koyu ton) · outlined (yüzey zemini, renkli kenar ve ikon) · minimal (nötr kenar, gölgesiz, yalnız ikon renkli). kind default ve loading renksizdir: filled onlarda soft'la aynı çizilir.",
|
|
2095
|
-
size: "sm | md (varsayılan) | lg → kart genişliği 300 / 356 / 420px, dolgu ve yazı boyu birlikte değişir. 480px altında her boyut tam genişliktir.",
|
|
2096
|
-
style: "Kart köküne uygulanır (background, border…). Parça seçicileri: '&__title', '&__content', '&__icon', '&__actions'. Tür/görünüm renklerini ezer."
|
|
1965
|
+
isHidden: 'Açıkken komponent hiç kurulmaz: toast ATILMAZ. Gizli bir tetikleyici değil, kapalı bir tetikleyicidir — isOpen true yazmak da bir şey göstermez.'
|
|
2097
1966
|
}
|
|
2098
1967
|
},
|
|
2099
1968
|
// — 2026-08-27 eşleme turu: components-new dalıyla gelen 6 yeni komponent.
|