@virusis/angular-ui 0.1.0

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/index.d.ts ADDED
@@ -0,0 +1,3510 @@
1
+ import * as i0 from '@angular/core';
2
+ import { EventEmitter, InjectionToken, OnInit, OnChanges, TemplateRef, AfterViewChecked, OnDestroy, AfterContentInit, Provider, Type } from '@angular/core';
3
+ import { ThemeMode, VpSeverity, SeverityScale } from '@virusis/design-tokens';
4
+ export { THEME_MODES, ThemeMode } from '@virusis/design-tokens';
5
+ import { MenuItem } from 'primeng/api';
6
+ import { SortOrder } from '@virusis/platform-contracts';
7
+ import { CanDeactivateFn, CanActivateFn } from '@angular/router';
8
+ import { Observable } from 'rxjs';
9
+ import { HttpInterceptor, HttpRequest, HttpHandler, HttpEvent, HttpClient } from '@angular/common/http';
10
+
11
+ /** Gomulen sprite dugumunun id'si — ikinci kopyayi engelleyen tek isaret. */
12
+ declare const VP_ICON_SPRITE_ID = "vp-icon-sprite";
13
+ /**
14
+ * SVG sembol deposunu belgeye gomer.
15
+ *
16
+ * ## 🔴 Neden var: olculen sessiz kayip
17
+ *
18
+ * DS'te 16 bilesen ikonlarini `<use href="#vp-icon-...">` ile ciziyor. Bu
19
+ * yalniz sembolleri iceren sprite **ayni belgede** varsa calisir. Sprite
20
+ * `@virusis/icon-set` icinde uretiliyordu ama **hicbir uygulamaya
21
+ * gomulmuyordu**: `buildSprite()` sifir tuketicili, uc konsol paketi
22
+ * bagimliligi yazip hic import etmemis.
23
+ *
24
+ * ⚠️ Cozulemeyen `<use>` **hicbir sey cizmez ve hata vermez**. Konsol sessiz,
25
+ * test yesil — cunku `<use>` elemani DOM'da duruyor. Yalniz goz gorur.
26
+ *
27
+ * ## Neden servis, neden kurucuda
28
+ *
29
+ * Gomme isi tek bir "uygulama acilisinda cagir" adimi olsaydi, bes konsolda
30
+ * bes ayri baglanti noktasi olur ve **biri unutulurdu** — bu depoda tekrar
31
+ * eden hata tam olarak bu. Bunun yerine is servisin **kurucusuna** baglandi:
32
+ * ikon cizen bilesen servisi enjekte eder, gomme kendiliginden olur. Ayrica
33
+ * cagirmak gerekmiyor, dolayisiyla unutulacak bir cagri da yok.
34
+ *
35
+ * 📌 `providedIn: 'root'` sayesinde uygulama basina tek ornek — sprite bir kez
36
+ * gomulur.
37
+ */
38
+ declare class VpIconSpriteService {
39
+ private readonly document;
40
+ constructor();
41
+ /**
42
+ * Sprite yoksa gomer; varsa dokunmaz.
43
+ *
44
+ * ⚠️ `innerHTML` KULLANILMIYOR: `DOMParser` ile ayristirilip `importNode` ile
45
+ * aliniyor. Sebep, siki CSP / Trusted Types ayarlarinda `innerHTML` atamasinin
46
+ * engellenmesi — ikonlarin bir guvenlik ayarina takilip sessizce kaybolmasi
47
+ * tam da duzeltmeye calistigimiz hatanin tekrari olurdu.
48
+ *
49
+ * 📌 Sunucu tarafinda (`Prime` SSR) `DOMParser` yok; orada sessizce atlanir
50
+ * ve gomme, tarayicida hidrasyondan sonra yapilir.
51
+ */
52
+ ensure(): void;
53
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpIconSpriteService, never>;
54
+ static ɵprov: i0.ɵɵInjectableDeclaration<VpIconSpriteService>;
55
+ }
56
+
57
+ /**
58
+ * Durum ekrani varyantlari — paket 06.
59
+ *
60
+ * Kural: **her durumun bir cikis yolu vardir.** `loading` disindaki her varyant
61
+ * en az bir aksiyon sunmak zorundadir. Cikissiz ekran kullanicinin urune olan
62
+ * guvenini kirar ve geri donmesini engeller.
63
+ *
64
+ * Yasak: bos ekran · yalnizca hata kodu · cikissiz kilitlenme · urun disina atma.
65
+ */
66
+ type VpStateType = 'loading' | 'empty' | 'empty-filtered' | 'error' | 'unauthorized' | 'not-found' | 'rate-limit' | 'offline' | 'maintenance' | 'blocked' | 'challenge' | 'limited' | 'appeal';
67
+ type VpStateTone = 'neutral' | 'info' | 'warning' | 'danger' | 'inviting';
68
+ interface VpStateAction {
69
+ /**
70
+ * Kullaniciya **gorunen metin**.
71
+ *
72
+ * 🔴 Burada bir i18n anahtari durmaz. Bilesenin icinde ceviri katmani yok ve
73
+ * tuketicide de yok: anahtar dogrudan ekrana basilir. 2026-08-23'e kadar oyleydi
74
+ * ve kullanici `state.empty.action` yazan bir dugme goruyordu — Customer Console
75
+ * ile AdminPanel'de canliydi.
76
+ */
77
+ label: string;
78
+ /** `primary` gorsel olarak one cikar; `secondary` yardimci */
79
+ kind: 'primary' | 'secondary';
80
+ }
81
+ interface VpStateVariant {
82
+ /** `@virusis/icon-set` ikon adi */
83
+ icon: string;
84
+ /**
85
+ * Varsayilan baslik — **duz Turkce metin**, anahtar degil.
86
+ *
87
+ * ⚠️ Ad `Key` ile bitiyor ama icerik anahtar **degil**; ad geriye uyum icin
88
+ * korundu (dis tuketiciler alani okuyor). Yanlis ad yeniden anahtar yazmaya
89
+ * davet ediyor; tip yorumu bu yuzden burada.
90
+ */
91
+ titleKey: string;
92
+ /** Varsayilan aciklama — duz Turkce metin. */
93
+ descriptionKey: string;
94
+ tone: VpStateTone;
95
+ /**
96
+ * `alert` — kullaniciyi kesintiye ugratan hata; ekran okuyucu hemen duyurur
97
+ * `status` — bilgilendirme; sira bekler
98
+ */
99
+ live: 'alert' | 'status';
100
+ actions: VpStateAction[];
101
+ }
102
+ /**
103
+ * 13 varyant. Metinler `brand-kit/04-voice-tone.md` kurallarina uyar:
104
+ * sakin, suclayici degil, ne oldugunu ve ne yapilacagini soyler.
105
+ */
106
+ declare const VP_STATE_VARIANTS: Record<VpStateType, VpStateVariant>;
107
+ /** Saniyeyi `mm:ss` bicimine cevirir. Negatif ve tasan degerleri sinirlar. */
108
+ declare function formatCountdown(totalSeconds: number): string;
109
+
110
+ /**
111
+ * Ortak durum ekrani — paket 06 · G1.
112
+ *
113
+ * 13 varyant. loading disindaki her varyant **en az bir aksiyon** sunar;
114
+ * cikissiz ekran yasak.
115
+ *
116
+ * Renk yalnizca token'dan gelir (--vp-*); ham palet sinifi kullanilmaz.
117
+ * Anlam renkle degil **ikon + baslik + metin** ile tasinir (WCAG 1.4.1).
118
+ *
119
+ * ⚠️ Stiller styles: [] ile satir ici. Harici styleUrl JIT test ortaminda
120
+ * cozulemiyor ("Component is not resolved"); kutuphane bileseni oldugu icin
121
+ * satir ici stil tuketici uygulamada ek yapilandirma da gerektirmez.
122
+ */
123
+ declare class VpStateComponent {
124
+ /**
125
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
126
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
127
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
128
+ *
129
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
130
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
131
+ */
132
+ protected readonly iconSprite: VpIconSpriteService;
133
+ /**
134
+ * ⚠️ Sinyal input() yerine klasik @Input() kullaniliyor.
135
+ * JIT test ortaminda sinyal girdileri NG0303 veriyor (derleyici donusumu
136
+ * uygulanmiyor). Tuketici uygulamalar da decorator tabanli — tutarli.
137
+ */
138
+ type: VpStateType;
139
+ /** Varyant varsayilanini ezmek icin */
140
+ title: string | null;
141
+ description: string | null;
142
+ /**
143
+ * Aksiyon dugmelerinin metni.
144
+ *
145
+ * 🔴 Eklenmesinin sebebi: varyant tablosu etiketleri i18n **anahtari** olarak
146
+ * tutuyordu (`state.empty.action`) ve sablon onlari duz basiyordu. Bilesenin
147
+ * icinde ceviri katmani yok, tuketicide de yok — kullanici ekranda anahtari
148
+ * goruyordu. Varsayilanlar duz Turkce metne cevrildi; bunlar da tuketicinin
149
+ * kendi diline gecmesi icin.
150
+ */
151
+ primaryLabel: string | null;
152
+ secondaryLabel: string | null;
153
+ /** Kopyalanabilir referans kodu — destek ekibiyle eslesme icin */
154
+ reference: string | null;
155
+ /** Kalan sure (saniye). Verilirse geri sayim gosterilir. */
156
+ remainingSeconds: number | null;
157
+ loadingLabel: string;
158
+ countdownLabel: string;
159
+ referenceLabel: string;
160
+ copyLabel: string;
161
+ /**
162
+ * Basligin belge sirasindaki seviyesi.
163
+ *
164
+ * 🔴 Bilesen basligini her zaman `<h2>` ciziyordu. Sayfanin **tum** icerigi
165
+ * bir `vp-state` oldugunda — hata sayfasi ve `anon-callback` tam olarak boyle —
166
+ * sayfada hic `h1` kalmiyor ve baslik sirasi dogrudan 2'den basliyor. Ekran
167
+ * okuyucu kullanicisi bashklarla gezerken sayfanin **adini** hic duymuyor;
168
+ * ustelik bu, yolunu kaybetmis kullanicinin indigi sayfa.
169
+ *
170
+ * ⚠️ Varsayilan **2 kaliyor**: bilesen tablo icinde de kullaniliyor ve orada
171
+ * sayfa basligi degil bolum basligi. Seviyeyi **cagiran** biliyor; varsayilani
172
+ * degistirmek gomulu her kullanimi sessizce bozardi.
173
+ */
174
+ headingLevel: 1 | 2 | 3;
175
+ /** Aralik disi deger sessizce kabul edilmiyor: 7. seviye baslik yok. */
176
+ protected get resolvedHeadingLevel(): 1 | 2 | 3;
177
+ readonly primaryAction: EventEmitter<void>;
178
+ readonly secondaryAction: EventEmitter<void>;
179
+ readonly referenceCopied: EventEmitter<string>;
180
+ protected get variant(): VpStateVariant;
181
+ protected get resolvedTitle(): string;
182
+ protected get resolvedDescription(): string;
183
+ protected get countdown(): string | null;
184
+ /** Disaridan verilen etiket varsa o, yoksa varyantin Turkce varsayilani. */
185
+ protected actionLabel(action: VpStateAction): string;
186
+ protected emit(kind: 'primary' | 'secondary'): void;
187
+ protected copy(value: string): void;
188
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpStateComponent, never>;
189
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpStateComponent, "vp-state", never, { "type": { "alias": "type"; "required": true; }; "title": { "alias": "title"; "required": false; }; "description": { "alias": "description"; "required": false; }; "primaryLabel": { "alias": "primaryLabel"; "required": false; }; "secondaryLabel": { "alias": "secondaryLabel"; "required": false; }; "reference": { "alias": "reference"; "required": false; }; "remainingSeconds": { "alias": "remainingSeconds"; "required": false; }; "loadingLabel": { "alias": "loadingLabel"; "required": false; }; "countdownLabel": { "alias": "countdownLabel"; "required": false; }; "referenceLabel": { "alias": "referenceLabel"; "required": false; }; "copyLabel": { "alias": "copyLabel"; "required": false; }; "headingLevel": { "alias": "headingLevel"; "required": false; }; }, { "primaryAction": "primaryAction"; "secondaryAction": "secondaryAction"; "referenceCopied": "referenceCopied"; }, never, never, true, never>;
190
+ }
191
+
192
+ interface VpAppealSubmission {
193
+ /** Kullanicinin gorebildigi olay referansi — destek bu kodla vakayi bulur. */
194
+ referenceCode: string;
195
+ reason: string;
196
+ contact?: string;
197
+ }
198
+ /**
199
+ * Itiraz formu — paket 06 · G4.
200
+ *
201
+ * `vp-state` bir DURUM gosterir; itiraz bir FORM'dur (envanter bulgusu §T8:
202
+ * `challenge`/`appeal`/`maintenance` gercek form, `vp-state` adayi degil).
203
+ *
204
+ * ## 🔴 Referans kodu formun parcasi
205
+ *
206
+ * Kullanici engellendi, sinirlandi veya dogrulama istendi — bu ekranlarin hepsinde
207
+ * bir olay referansi var. Itiraz o referansi TASIMAZSA destek tarafinda vaka
208
+ * bulunamaz ve kullanici "kimse bakmadi" der. Kod formda **gorunur** ve gonderiye
209
+ * dahildir; kullanicinin elle kopyalamasina birakilmaz.
210
+ *
211
+ * ## 🔴 Ikinci gonderim engellenir
212
+ *
213
+ * Ag yavassa kullanici dugmeye tekrar basar. Aynı itirazin iki kez acilmasi destek
214
+ * tarafinda kopya vaka uretir. `submitting` ve `submitted` durumlarinda dugme pasif.
215
+ */
216
+ declare class VpAppealFormComponent {
217
+ private static seq;
218
+ referenceCode: string;
219
+ submitting: boolean;
220
+ submitted: boolean;
221
+ /** Sunucudan donen hata. Bos ise hata satiri render EDILMEZ. */
222
+ error: string;
223
+ referenceLabel: string;
224
+ reasonLabel: string;
225
+ reasonHint: string;
226
+ contactLabel: string;
227
+ submitLabel: string;
228
+ submittingLabel: string;
229
+ emptyReasonError: string;
230
+ successTitle: string;
231
+ successNote: string;
232
+ readonly appealSubmit: EventEmitter<VpAppealSubmission>;
233
+ protected reason: string;
234
+ protected contact: string;
235
+ protected showEmptyError: boolean;
236
+ protected readonly hintId: string;
237
+ /**
238
+ * `FormsModule` BILEREK kullanilmiyor: tasarim sistemi Angular forms modulune
239
+ * bagimli olmamali — tuketici reactive forms, template forms veya hicbirini
240
+ * kullaniyor olabilir. Deger okuma tek satirlik bir yardimciya indi.
241
+ */
242
+ protected asValue(event: Event): string;
243
+ /** `ngSubmit` FormsModule direktifidir; ham `submit` olayi kullaniliyor. */
244
+ protected onSubmit(event: Event): void;
245
+ submit(): void;
246
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpAppealFormComponent, never>;
247
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpAppealFormComponent, "vp-appeal-form", never, { "referenceCode": { "alias": "referenceCode"; "required": true; }; "submitting": { "alias": "submitting"; "required": false; }; "submitted": { "alias": "submitted"; "required": false; }; "error": { "alias": "error"; "required": false; }; "referenceLabel": { "alias": "referenceLabel"; "required": false; }; "reasonLabel": { "alias": "reasonLabel"; "required": false; }; "reasonHint": { "alias": "reasonHint"; "required": false; }; "contactLabel": { "alias": "contactLabel"; "required": false; }; "submitLabel": { "alias": "submitLabel"; "required": false; }; "submittingLabel": { "alias": "submittingLabel"; "required": false; }; "emptyReasonError": { "alias": "emptyReasonError"; "required": false; }; "successTitle": { "alias": "successTitle"; "required": false; }; "successNote": { "alias": "successNote"; "required": false; }; }, { "appealSubmit": "appealSubmit"; }, never, never, true, never>;
248
+ }
249
+
250
+ /**
251
+ * Paket 15 · G6 + G7 — satır içi dönüşüm teklifleri ve sıra kuralı.
252
+ *
253
+ * 🔴 **Modal yok** (analiz §1.6). Akışı kesen bir teklif, kullanıcının yaptığı işi
254
+ * durdurup ondan bir karar ister; o kararın cevabı neredeyse her zaman "kapat"
255
+ * olur ve teklif harcanır. Satır içi teklif ise kullanıcı hazır olduğunda okur.
256
+ *
257
+ * 🔴 **Aynı anda en fazla bir istem** (G7). Geri bildirim istemi ile dönüşüm
258
+ * teklifi aynı ekranda çıkarsa ikisi de kaybeder: kullanıcı birini kapatırken
259
+ * diğerini de refleksle kapatır ve iki fırsatın ikisi de harcanır.
260
+ */
261
+ /** Sunum biçimi. Tek değer var ve bu bilinçli — bkz. dosya başı. */
262
+ type VpPromptPresentation = 'inline';
263
+ type VpPromptKind = 'feedback' | 'conversion';
264
+ /**
265
+ * Bir oturumda gösterilecek en fazla dönüşüm teklifi.
266
+ *
267
+ * Her taramada teklif göstermek, teklifi arayüzün gürültüsüne çevirir: kullanıcı
268
+ * onu bir bileşen sanmaya başlar ve okumayı bırakır.
269
+ */
270
+ declare const MAX_CONVERSION_PROMPTS_PER_SESSION = 2;
271
+ interface VpPromptContext {
272
+ /** Kullanıcının hesabı var mı. Varsa dönüşüm teklifinin konusu kalmıyor. */
273
+ isAnonymous: boolean;
274
+ /** Bu oturumdaki tarama sayısı. */
275
+ scanCount: number;
276
+ /** `firstScanFeedbackShownAt` yazılmış mı — geri bildirim daha önce soruldu mu. */
277
+ feedbackAlreadyShown: boolean;
278
+ /** Bu oturumda geri bildirim istemi gösterildi mi. */
279
+ feedbackShownInSession: boolean;
280
+ /** Bu oturumda kaç dönüşüm teklifi gösterildi. */
281
+ conversionShownInSession: number;
282
+ }
283
+ interface VpConversionMoment {
284
+ /** Sabit anahtar — metin değişse de ölçüm bozulmasın. */
285
+ momentKey: string;
286
+ /** Bu andan itibaren geçerli (dahil). */
287
+ fromScanCount: number;
288
+ title: string;
289
+ /** Kullanıcının ne kazanacağı. Teklifin gövdesi. */
290
+ body: string;
291
+ /** Düğme metni. Eylemsiz teklif reklamdır. */
292
+ action: string;
293
+ presentation: VpPromptPresentation;
294
+ }
295
+ /**
296
+ * Doğal teklif anları (analiz §1.6).
297
+ *
298
+ * Sıra **azalan** okunuyor: verilen tarama sayısına uyan **en yüksek** eşik
299
+ * seçiliyor. Son an üstündeki her sayı için geçerli — tanımsız bir aralık
300
+ * bırakmak, teklifin belirli bir sayıdan sonra sessizce kaybolması demekti.
301
+ */
302
+ declare const CONVERSION_MOMENTS: readonly VpConversionMoment[];
303
+ /**
304
+ * Şu an hangi istem gösterilmeli — ya da hiçbiri.
305
+ *
306
+ * 🔴 Geri bildirim önce geliyor çünkü **tek atış**: `firstScanFeedbackShownAt` bir
307
+ * kez yazılıyor ve kaçırılırsa bir daha sorulmuyor. Dönüşüm teklifi ise sonraki
308
+ * taramada yine çıkacak. İki fırsattan biri geri alınamıyorsa, geri çekilmesi
309
+ * gereken diğeridir.
310
+ */
311
+ declare function nextPrompt(context: VpPromptContext): VpPromptKind | null;
312
+ /** Tarama sayısına uyan teklif; hiç tarama yoksa `null`. */
313
+ declare function conversionOfferFor(scanCount: number): VpConversionMoment | null;
314
+
315
+ /**
316
+ * Uygulama kabugu — paket 05 · G2.
317
+ *
318
+ * Landmark sozlesmesi (WCAG 2.2 · 1.3.1 · 2.4.1):
319
+ * header -> banner (ust cubuk)
320
+ * aside -> complementary (kenar cubugu)
321
+ * main -> main **TEK TANE**
322
+ *
323
+ * Uc uygulamada da ayri ayri yazilmis kabuklar vardi; bu bileşen onlarin
324
+ * yerine gecer. Icerik ng-content ile yansitilir, kabuk yerlesimi bilir.
325
+ */
326
+ declare class VpShellComponent {
327
+ /**
328
+ * Kenar cubugunun `id`'si — `vp-sidebar-toggle`'in `controls` girdisiyle
329
+ * AYNI olmali. Ikisinin varsayilani da `'vp-sidebar'`.
330
+ */
331
+ sidebarId: string;
332
+ /**
333
+ * Dar ekranda kenar cubugu overlay olarak aciliyor; kapatma isteği disari
334
+ * bildiriliyor.
335
+ *
336
+ * 🔴 Durum KABUKTA tutulmuyor: `collapsed` girdisi uygulamanin. Burada
337
+ * ikinci bir kopya tutmak, bu depoda tekrar eden "iki kaynak ayrisir"
338
+ * hatasini davet ederdi.
339
+ */
340
+ /**
341
+ * Menu kipi — `static` akista, `overlay` icerigin ustunde.
342
+ *
343
+ * 🔴 AdminPanel'in canli kabugu bu iki kipi PrimeNG `containerClass` ile
344
+ * yurutuyor (`layout-static` · `layout-overlay`). Ortak kabuk yalniz
345
+ * `collapsed` tasidigi surece o kabugun yerine GECEMEZ — tasima yetenegi
346
+ * dusururdu. Bu girdi o boslugu kapatiyor.
347
+ *
348
+ * ⚠️ Dar ekranda kip DIKKATE ALINMAZ: overlay zorunlu. `static` bir menu
349
+ * 390px'te icerigin yarisini yer.
350
+ */
351
+ menuMode: 'static' | 'overlay';
352
+ readonly collapsedChange: EventEmitter<boolean>;
353
+ private readonly isBrowser;
354
+ /** Dar ekran mi — overlay'i zorunlu kilar. */
355
+ protected readonly narrow: i0.WritableSignal<boolean>;
356
+ /** Kenar cubugu icerigin USTUNDE mi duruyor. */
357
+ protected overlay(): boolean;
358
+ constructor();
359
+ /** Kenar cubugu daraltilmis mi (260px -> 64px) */
360
+ collapsed: boolean;
361
+ skipLabel: string;
362
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpShellComponent, never>;
363
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpShellComponent, "vp-shell", never, { "sidebarId": { "alias": "sidebarId"; "required": false; }; "menuMode": { "alias": "menuMode"; "required": false; }; "collapsed": { "alias": "collapsed"; "required": false; }; "skipLabel": { "alias": "skipLabel"; "required": false; }; }, { "collapsedChange": "collapsedChange"; }, never, ["[topbar]", "[sidebar]", "*"], true, never>;
364
+ }
365
+
366
+ /**
367
+ * Ana icerige atlama baglantisi — WCAG 2.2 · 2.4.1 (blok atlama).
368
+ *
369
+ * 🔴 **Neden ayri bir bilesen:** kural `vp-shell`'in icinde yaziliydi ve o
370
+ * kabugu yalnizca Customer Console kullaniyor. Prime · AdminPanel ·
371
+ * PrivateAPI-UI · LocalAdmin kendi yerlesimlerini tasiyor ve dordunde de
372
+ * atlama baglantisi **yoktu** — klavye kullanicisi her sayfada menunun
373
+ * tamamini gecmek zorundaydi. Kabugu degistirmek buyuk bir is; kurali tek
374
+ * satirla eklemek degil.
375
+ *
376
+ * ⚠️ Hedef `id` **ayni sayfada bir `main` ogesine** ait olmali ve o oge
377
+ * `tabindex="-1"` tasimali. Aksi halde baglanti odaklanmayi tasimaz: tarayici
378
+ * kaydirir ama odak ust cubukta kalir ve bir sonraki `Tab` kullaniciyi gerisin
379
+ * geri menuye atar — yani baglanti calisiyor gorunup ise yaramaz.
380
+ *
381
+ * Kullanim:
382
+ * ```html
383
+ * <vp-skip-link />
384
+ * <header>…</header>
385
+ * <main id="vp-main" tabindex="-1">…</main>
386
+ * ```
387
+ */
388
+ declare class VpSkipLinkComponent {
389
+ /** Hedef `main` ogesinin `id`'si. */
390
+ targetId: string;
391
+ /** Paket kuralina uygun: Turkce varsayilan, `@Input` ile ezilir. */
392
+ label: string;
393
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpSkipLinkComponent, never>;
394
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpSkipLinkComponent, "vp-skip-link", never, { "targetId": { "alias": "targetId"; "required": false; }; "label": { "alias": "label"; "required": false; }; }, {}, never, never, true, never>;
395
+ }
396
+
397
+ /**
398
+ * Sayfa basligi — paket 05 · G6.
399
+ *
400
+ * Sayfa basina TEK h1. Kabuk main landmark'i sagliyor; bu bilesen
401
+ * ona baslik veriyor. Aksiyonlar sagda, baslik solda.
402
+ */
403
+ declare class VpPageHeaderComponent {
404
+ heading: string;
405
+ description: string | null;
406
+ /** Kayit sayisi. 0 da gosterilir — "bos" ile "sifir" farkli bilgidir. */
407
+ count: number | null;
408
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpPageHeaderComponent, never>;
409
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpPageHeaderComponent, "vp-page-header", never, { "heading": { "alias": "heading"; "required": true; }; "description": { "alias": "description"; "required": false; }; "count": { "alias": "count"; "required": false; }; }, {}, never, ["[actions]"], true, never>;
410
+ }
411
+
412
+ type VpBannerTone = 'info' | 'warning' | 'danger' | 'success';
413
+ /**
414
+ * Sayfa ustu bildirim seridi — paket 06 · G2.
415
+ *
416
+ * Kullanim: bakim · cevrimdisi · backend erisilemez · trial limiti.
417
+ *
418
+ * ⚠️ Kalici bannerlar (dismissible = false) kapatilamaz. Bakim gibi durumlar
419
+ * kullanici kapatinca kaybolmamali — sorun devam ediyor demektir.
420
+ */
421
+ declare class VpBannerComponent {
422
+ /**
423
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
424
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
425
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
426
+ *
427
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
428
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
429
+ */
430
+ protected readonly iconSprite: VpIconSpriteService;
431
+ message: string;
432
+ tone: VpBannerTone;
433
+ /** Kalici bannerlar kapatilamaz — bkz. sinif yorumu. */
434
+ dismissible: boolean;
435
+ dismissLabel: string;
436
+ readonly dismissed: EventEmitter<void>;
437
+ protected get isUrgent(): boolean;
438
+ protected get icon(): string;
439
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpBannerComponent, never>;
440
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpBannerComponent, "vp-banner", never, { "message": { "alias": "message"; "required": true; }; "tone": { "alias": "tone"; "required": false; }; "dismissible": { "alias": "dismissible"; "required": false; }; "dismissLabel": { "alias": "dismissLabel"; "required": false; }; }, { "dismissed": "dismissed"; }, never, ["[actions]"], true, never>;
441
+ }
442
+
443
+ /**
444
+ * Ust cubuk kabugu — paket 05 · G4.
445
+ *
446
+ * ## Neden davranis tasimiyor
447
+ *
448
+ * T1 envanteri (`Docs/implementation/05-angular-ui-shell/topbar-envanteri.md`)
449
+ * uc topbar'in **gercekten farkli** oldugunu gosterdi:
450
+ *
451
+ * Prime 18 satir — yalniz tema gecisi
452
+ * AdminPanel 67 satir — kullanici menusu · AppKey · kaydirma
453
+ * PrivateAPI 147 satir — dil · UC DURUMLU tema · bildirim · tarayici izni
454
+ *
455
+ * Tema modeli bile uyusmuyor: Prime/AdminPanel ikili (`darkTheme: boolean`),
456
+ * PrivateAPI uc durumlu (`'dark' | 'light' | 'auto'`). Naif birlestirme
457
+ * PrivateAPI'nin `auto` modunu **silerdi**.
458
+ *
459
+ * Bu yuzden `vp-topbar` **kabuk + yuva**: yerlesimi, landmark'i ve uc uygulamada
460
+ * kopyalanmis kaydirma efektini saglar; davranislar uygulamada kalir ve kaybolmaz.
461
+ */
462
+ declare class VpTopbarComponent {
463
+ /**
464
+ * Sayfa kaydirildi mi. Kaydirma dinleyicisi uygulamada kalir — kabuk
465
+ * `window` olaylarina baglanmaz (SSR ve test ortaminda sorun cikarir).
466
+ */
467
+ scrolled: boolean;
468
+ landmarkLabel: string;
469
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpTopbarComponent, never>;
470
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpTopbarComponent, "vp-topbar", never, { "scrolled": { "alias": "scrolled"; "required": false; }; "landmarkLabel": { "alias": "landmarkLabel"; "required": false; }; }, {}, never, ["[brand]", "[start]", "[actions]", "[user]"], true, never>;
471
+ }
472
+
473
+ /**
474
+ * Menu sozlesmesi — paket 16 · G1 ile hizali.
475
+ *
476
+ * Olculen eksikler (`Menus` tablosu, 64 kayit): `Path` kolonu YOK ·
477
+ * `ApplicationId` YOK · `Menu.titleKey` YOK (yalniz `MenuGroup`'ta var).
478
+ * Bu tip **hedef** sozlesmedir; backend semasi paket 16 · G2 ile yetisecek.
479
+ */
480
+ interface VpMenuItem {
481
+ /** Kararli kimlik — id degil; uygulamalar arasi tasinabilir olmali */
482
+ code: string;
483
+ /** Rota. Menu kaydi rotasini KENDISI tasir; frontend'de elle esleme YOK. */
484
+ path: string;
485
+ /** i18n anahtari veya duz metin */
486
+ titleKey: string;
487
+ icon?: string;
488
+ /** Sayac rozeti */
489
+ badge?: number;
490
+ /**
491
+ * Gezinme grubu basligi — or. "CALISMA", "HESAP".
492
+ *
493
+ * 🔴 Paket 17 §6.1 "Navigation groups" maddesini **P0** sayiyor; §6.2
494
+ * Customer icin hedef bilgi mimarisini uc gruba boluyor. Duz liste, madde
495
+ * sayisi arttikca taranamaz hale geliyor: kullanici aradigini bulmak icin
496
+ * her seferinde butun listeyi okumak zorunda kaliyor.
497
+ *
498
+ * ⚠️ Bos birakilan maddeler gruplanmamis olarak listenin BASINDA cikar.
499
+ * Zorunlu yapmak, tek bolumlu konsollari bir grup adi uydurmaya zorlardi.
500
+ */
501
+ group?: string;
502
+ /**
503
+ * **Yetkisiz** madde — kullaniciya varligi bile soylenmez.
504
+ * Yetki, "yapabilir mi" sorusudur.
505
+ */
506
+ hidden?: boolean;
507
+ /**
508
+ * **Kosulu saglamayan** madde — gorunur ama devre disi, sebebi yazili.
509
+ * Kosul, "plani destekliyor mu" sorusudur; yetkiden FARKLI bir eksen.
510
+ *
511
+ * Kural: gorunmeyen ozellik satilamaz.
512
+ */
513
+ disabledReason?: string;
514
+ }
515
+ interface VpCrumb {
516
+ label: string;
517
+ path: string;
518
+ }
519
+
520
+ /**
521
+ * Kenar cubugu menusu — paket 05 · G3.
522
+ *
523
+ * Paket 16 kurali burada uygulanir:
524
+ * yetkisiz -> GORUNMEZ (hidden)
525
+ * kosul saglanmadi -> devre disi + SEBEP (disabledReason)
526
+ * ikisi de yok -> etkin link
527
+ *
528
+ * Gorunmeyen ozellik satilamaz; "planiniza dahil degil" maddelerini gizlemek
529
+ * yerine sebebiyle gosteriyoruz.
530
+ */
531
+ declare class VpSidebarComponent {
532
+ items: VpMenuItem[];
533
+ collapsed: boolean;
534
+ navLabel: string;
535
+ badgeLabel: string;
536
+ /** Yetkisiz maddeler hic render edilmez. */
537
+ protected get visibleItems(): VpMenuItem[];
538
+ /**
539
+ * Maddeleri gruplarina bolerek, ILK GORULDUKLERI SIRAYLA dondurur.
540
+ *
541
+ * ⚠️ Alfabetik siralanMIYOR: menu sirasi bir urun karari (paket 17 §6.2
542
+ * bilgi mimarisi) ve alfabe onu bozardi. Grup adi olmayan maddeler tek bir
543
+ * adsiz grupta, listenin basinda kalir.
544
+ *
545
+ * 📌 Sozlesme geriye uyumlu: hicbir madde `group` tasimazsa tek adsiz grup
546
+ * olusur ve cikti eskisiyle ayni kalir.
547
+ */
548
+ protected get groups(): {
549
+ name: string;
550
+ items: VpMenuItem[];
551
+ }[];
552
+ /**
553
+ * 🔴 Menu ikonu PrimeIcons sinifidir, sprite sembolu DEGIL.
554
+ *
555
+ * Olculen hata (2026-08-28): burada ad `'#vp-icon-' + item.icon` diye
556
+ * birlestiriliyordu. Her cagiran PrimeIcons adi veriyor (`pi-home`,
557
+ * `pi pi-table`), yani uretilen `#vp-icon-pi-home` hicbir zaman cozulmedi ve
558
+ * bes konsolda kenar cubugu ikonlari **hic cizilmedi**. Cozulemeyen `<use>`
559
+ * sessizdir: hata vermez, sadece bosluk birakir.
560
+ */
561
+ protected iconClass(item: VpMenuItem): string;
562
+ protected hasBadge(item: VpMenuItem): boolean;
563
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpSidebarComponent, never>;
564
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpSidebarComponent, "vp-sidebar", never, { "items": { "alias": "items"; "required": true; }; "collapsed": { "alias": "collapsed"; "required": false; }; "navLabel": { "alias": "navLabel"; "required": false; }; "badgeLabel": { "alias": "badgeLabel"; "required": false; }; }, {}, never, never, true, never>;
565
+ }
566
+
567
+ /**
568
+ * Kirinti izi — paket 05 · G5.
569
+ *
570
+ * Kurallar:
571
+ * - Adlandirilmis `nav` (sayfada birden fazla nav var: ana menu + kirinti)
572
+ * - SON oge link DEGIL — kullanici zaten orada
573
+ * - Son ogede `aria-current="page"`
574
+ * - Ayiraclar dekoratif; ekran okuyucu okumaz
575
+ */
576
+ declare class VpBreadcrumbComponent {
577
+ trail: VpCrumb[];
578
+ navLabel: string;
579
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpBreadcrumbComponent, never>;
580
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpBreadcrumbComponent, "vp-breadcrumb", never, { "trail": { "alias": "trail"; "required": true; }; "navLabel": { "alias": "navLabel"; "required": false; }; }, {}, never, never, true, never>;
581
+ }
582
+
583
+ /**
584
+ * Tema kontrolu — paket 17 §6.1, **P0**.
585
+ *
586
+ * Spec tam olarak uc durum istiyor: **sistem / acik / koyu**. Sablondan gelen
587
+ * PrimeNG tema yapilandirma paneli (renk · olcek · menu modu secici) TXT §5.7
588
+ * ile acikca **reddedildi**; premium panelin en gorunur "hazir tema" isareti
589
+ * oydu.
590
+ *
591
+ * 🔴 Bu bilesen mantik TASIMIYOR ve tasimamali. Durum yonetimi
592
+ * `createThemeModeController` (`@virusis/design-tokens`) icinde ve orasi
593
+ * dort hatanin duzeltildigi yer:
594
+ * 1. `themeMode` yazilmiyordu → yenilemede secim kayboluyordu
595
+ * 2. `auto` dinleyicisi omur boyu yasiyordu → acik secim eziliyordu
596
+ * 3. dongu baslangici tutarsizdi → ilk tiklama bir adim atliyordu
597
+ * 4. her `auto` secimi yeni abonelik aciyordu
598
+ *
599
+ * ⚠️ Olculdu (2026-08-26): bes topbar'dan **biri** o denetleyiciyi atlayip ham
600
+ * `darkTheme` cevirmesi yapiyordu ve panelde "uc secenek calismiyor" denmesinin
601
+ * sebebi buydu. Bu bilesenin var olma amaci, o atlamanin bir daha mumkun
602
+ * olmamasi: mod disaridan verilir, tiklama disari bildirilir.
603
+ *
604
+ * 📌 PrimeNG `p-button` SARMALANIYOR, kopyalanmiyor (paket 10 §6.2 kritik
605
+ * kurali). Klavye ve odak davranisi PrimeNG'den miras aliniyor.
606
+ *
607
+ * 🔴 Mod kumesi ve **dongu sirasi** `@virusis/design-tokens`'ten geliyor,
608
+ * burada yeniden yazilmiyor.
609
+ *
610
+ * Ilk surumu 'auto' | 'light' | 'dark' diye kendi yaziyor ve aria-label'da
611
+ * sirayi auto -> acik -> koyu varsayiyordu. Denetleyicinin gercek sirasi
612
+ * ise auto -> koyu -> acik. Yani bilesen kullaniciya YANLIS sonraki adimi
613
+ * soyluyordu — bu bilesenin onlemek icin var oldugu "iki kaynak ayrisir"
614
+ * hatasinin ta kendisi.
615
+ */
616
+ type VpThemeMode = ThemeMode;
617
+ declare class VpThemeControlComponent {
618
+ /** Gecerli mod — kaynak denetleyici, bu bilesen degil. */
619
+ mode: VpThemeMode;
620
+ autoLabel: string;
621
+ lightLabel: string;
622
+ darkLabel: string;
623
+ /**
624
+ * Tiklama disari bildirilir; sirayi burada YURUTMEYIZ.
625
+ *
626
+ * Dongu sirasi denetleyicinin isi — burada ikinci bir sira tutmak, iki
627
+ * kaynagin ayrismasi demekti ve bu paketin varlik sebebi tam da o.
628
+ */
629
+ readonly cycle: EventEmitter<void>;
630
+ protected get icon(): string;
631
+ protected get label(): string;
632
+ /** Sonraki mod — sirayi denetleyici belirler, bu bilesen degil. */
633
+ protected get nextMode(): VpThemeMode;
634
+ private labelFor;
635
+ /** Mevcut durum + sonraki adim. Yalniz ikon degistiren dugme sessizdir. */
636
+ protected get ariaLabel(): string;
637
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpThemeControlComponent, never>;
638
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpThemeControlComponent, "vp-theme-control", never, { "mode": { "alias": "mode"; "required": true; }; "autoLabel": { "alias": "autoLabel"; "required": false; }; "lightLabel": { "alias": "lightLabel"; "required": false; }; "darkLabel": { "alias": "darkLabel"; "required": false; }; }, { "cycle": "cycle"; }, never, never, true, never>;
639
+ }
640
+
641
+ /**
642
+ * Kenar cubugu ac/kapa — paket 17 §6.1, **P0**.
643
+ *
644
+ * 📌 `vp-sidebar` daraltilmis kipi (`collapsed`) zaten destekliyordu ama onu
645
+ * **cevirecek bir kontrol yoktu**: her konsol kendi dugmesini yaziyordu ya da
646
+ * hic yazmiyordu. Yetenek vardi, bagli degildi — bu depoda tekrarlayan desen.
647
+ *
648
+ * 🔴 `aria-expanded` ZORUNLU ve `aria-controls` ile birlikte anlamli: ekran
649
+ * okuyucu kullanicisi menunun acik mi kapali mi oldugunu yalniz buradan
650
+ * ogreniyor. Ikon tek basina hicbir sey soylemiyor.
651
+ *
652
+ * PrimeNG `p-button` sarmalaniyor, kopyalanmiyor (paket 10 §6.2).
653
+ */
654
+ declare class VpSidebarToggleComponent {
655
+ collapsed: boolean;
656
+ /**
657
+ * Kontrol edilen bolgenin `id`'si.
658
+ *
659
+ * ⚠️ Varsayilan verildi ama kabuk bunu **gercekten** o `id` ile eslestirmeli;
660
+ * eslesmeyen `aria-controls`, olmayan bir baglantiyi varmis gibi gosterir.
661
+ */
662
+ controls: string;
663
+ collapseLabel: string;
664
+ expandLabel: string;
665
+ readonly toggle: EventEmitter<void>;
666
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpSidebarToggleComponent, never>;
667
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpSidebarToggleComponent, "vp-sidebar-toggle", never, { "collapsed": { "alias": "collapsed"; "required": false; }; "controls": { "alias": "controls"; "required": false; }; "collapseLabel": { "alias": "collapseLabel"; "required": false; }; "expandLabel": { "alias": "expandLabel"; "required": false; }; }, { "toggle": "toggle"; }, never, never, true, never>;
668
+ }
669
+
670
+ /**
671
+ * Kullanici menusu — paket 17 §6.1, **P0**.
672
+ *
673
+ * Anthropic konsolunda oldugu gibi ust cubugun sag ucunda: kim oldugun, hangi
674
+ * rolle bagli oldugun ve cikis. Bugun her konsol bunu kendi yaziyordu ya da
675
+ * hic yazmiyordu.
676
+ *
677
+ * 🔴 Kimlik metni **kirpilmiyor**, `title` ile tam hali veriliyor: e-posta
678
+ * adresleri uzun ve ortadan kesilmis bir adres, yanlis hesapla giris yapmis
679
+ * kullanicinin bunu fark etmesini engeller.
680
+ *
681
+ * ⚠️ Menu maddeleri disaridan geliyor. Icerde sabit bir "Cikis" yazmak, cikis
682
+ * akisi konsoldan konsola farkli oldugu icin (KC post-logout listesi birebir
683
+ * eslesme istiyor) yanlis olurdu.
684
+ *
685
+ * PrimeNG `p-menu` + `p-button` sarmalaniyor; klavye gezinme ve odak yonetimi
686
+ * PrimeNG'den miras (paket 10 §6.2 — kopyalamiyoruz).
687
+ *
688
+ * 🔴 TUKETICI SARTI: uygulama `provideAnimationsAsync()` (ya da
689
+ * `provideNoopAnimations()`) cagirmali. `p-menu` acilirken sentetik
690
+ * animasyon dinleyicisi kuruyor; saglayici yoksa NG05105 ile duser —
691
+ * dugme gorunur ama menu acilmaz.
692
+ */
693
+ declare class VpUserMenuComponent {
694
+ displayName: string;
695
+ /** Rol, kiraci ya da e-posta — kimligi tek satirda ayirt etmeye yarayan sey. */
696
+ subtitle: string | null;
697
+ items: MenuItem[];
698
+ menuId: string;
699
+ readonly opened: EventEmitter<void>;
700
+ protected get initial(): string;
701
+ protected get ariaLabel(): string;
702
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpUserMenuComponent, never>;
703
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpUserMenuComponent, "vp-user-menu", never, { "displayName": { "alias": "displayName"; "required": true; }; "subtitle": { "alias": "subtitle"; "required": false; }; "items": { "alias": "items"; "required": false; }; "menuId": { "alias": "menuId"; "required": false; }; }, { "opened": "opened"; }, never, never, true, never>;
704
+ }
705
+
706
+ /**
707
+ * Tema modunun Angular baglantisi — paket 17 §6.1, **P0**.
708
+ *
709
+ * ## Neden burada
710
+ *
711
+ * Uc durumlu mod MANTIGI zaten `@virusis/design-tokens` icinde tek yerde
712
+ * (`createThemeModeController`, TEMA-MODU-2026-08-12). Ama onu Angular'a
713
+ * **baglayan** kod olculdu (2026-08-27) ve **alti kez kopyalanmisti**:
714
+ *
715
+ * Prime layout + layout-trial
716
+ * AdminPanel layout + layout-trial
717
+ * PrivateAPI layout
718
+ * Customer — YOK
719
+ * LocalAdmin — YOK
720
+ *
721
+ * Yani mantik paylasiliyordu, baglanti paylasilmiyordu; iki konsolda ise tema
722
+ * kontrolu hic yoktu. Bu servis o baglantiyi tek yere alir.
723
+ *
724
+ * ⚠️ Mevcut uc konsolun baglantisi kendi `layoutConfig` sinyaline bagli
725
+ * (`darkTheme` alani PrimeNG sablonundan miras). Onlari buraya gocurmek ayri
726
+ * bir istir ve BU SURUMDE YAPILMADI — bu servis, baglantisi olmayan iki konsol
727
+ * icin ve gocun hedefi olarak duruyor. Yedinci bir kopya yazmamak sarti.
728
+ *
729
+ * 🔴 Depo-ozel `LocalStorageService` / `DeviceService`'e bagimli DEGIL:
730
+ * ortak paket, dort konsolun hepsinde ayni sekilde calismak zorunda.
731
+ */
732
+ declare class VpThemeService {
733
+ private readonly isBrowser;
734
+ /**
735
+ * Su anki mod — sablon bunu okur.
736
+ *
737
+ * ⚠️ Denetleyici emirsel; sinyal onun **aynasi**. Her yazimdan sonra
738
+ * senkronlaniyor, aksi halde dugme eski modu gosterirdi.
739
+ */
740
+ private readonly modeSignal;
741
+ readonly mode: i0.Signal<"auto" | "dark" | "light">;
742
+ private readonly controller;
743
+ constructor();
744
+ /** Acilista bir kez. Iki kez cagrilabilir — denetleyici korunuyor. */
745
+ start(): void;
746
+ /** Bir sonraki mod. Sirayi denetleyici belirler, burasi degil. */
747
+ cycle(): void;
748
+ setMode(mode: ThemeMode): void;
749
+ /** Etkin koyuluk — `auto` ise isletim sistemi tercihi. */
750
+ isDark(): boolean;
751
+ private matchDark;
752
+ /**
753
+ * ⚠️ `localStorage` gizli sekmede ve depolama kapaliyken FIRLATIR. Okuma
754
+ * hatasi `auto`'ya duser; kalicilik kaybi calisan bir ozelligi engellememeli
755
+ * (denetleyicinin `writeMode` icin verdigi kararla ayni).
756
+ */
757
+ private readStoredMode;
758
+ private writeStoredMode;
759
+ private applyRootDarkClass;
760
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpThemeService, never>;
761
+ static ɵprov: i0.ɵɵInjectableDeclaration<VpThemeService>;
762
+ }
763
+ /**
764
+ * 🔴 `.app-dark` — PrimeNG preset'inin `darkModeSelector`'i ve
765
+ * `@virusis/design-tokens`'in urettigi CSS bunu bekliyor. Degistirmek koyu
766
+ * temayi sessizce olduren tek satirlik degisikliktir.
767
+ */
768
+ declare const VP_DARK_CLASS = "app-dark";
769
+ /** Mevcut uc konsolun kullandigi anahtar — gocte secim korunsun. */
770
+ declare const VP_THEME_STORAGE_KEY = "themeMode";
771
+
772
+ type VpToastTone = 'info' | 'success' | 'warning' | 'danger';
773
+ interface VpToast {
774
+ /** Kararli kimlik — kapatma ve aksiyon olaylarinda dondurulur */
775
+ id: string;
776
+ tone: VpToastTone;
777
+ message: string;
778
+ /**
779
+ * Verilirse bildirimde bir aksiyon dugmesi cikar ("Geri al" gibi).
780
+ * ⚠️ Aksiyonlu bildirim otomatik KAPANMAZ — aksiyona ulasilamaz kalirdi.
781
+ */
782
+ actionLabel?: string;
783
+ }
784
+ /**
785
+ * Otomatik kapanma politikasi — **tek kaynak**.
786
+ *
787
+ * 🔴 Once yalniz `VpToastComponent` uzerinde bir metottu. Zamanlayiciyi kuran
788
+ * taraf (servis) bir bilesen ornegine sahip olmadigi icin kurali kendi
789
+ * yazmak zorunda kalirdi — ve iki kopya, biri degisip digeri unutuldugunda
790
+ * ayrisir. Bu depoda tam olarak bu desen tekrar ediyor.
791
+ *
792
+ * `0` = kendiliginden kapanmaz.
793
+ */
794
+ declare function vpAutoDismissMs(toast: VpToast, defaultMs: number): number;
795
+
796
+ /**
797
+ * Bildirim yigininin sahibi — paket 17 §6.1 GlobalLayers, **P0**.
798
+ *
799
+ * ## Neden yazildi
800
+ *
801
+ * 🔴 Olculdu (2026-08-27): `vp-toast` ZATEN vardi, erisilebilirligi de dogru
802
+ * kurulmustu (aria-live her zaman DOM'da · hata `role="alert"` · hata
803
+ * kendiliginden kapanmaz). Ama **dort konsolun sifirinda** kullaniliyordu.
804
+ *
805
+ * Sebep tasarim degildi: bileseni besleyen hicbir sey yoktu. `toasts` bir
806
+ * girdi, zamanlayici kasitla ust bilesene birakilmis — ve o ust bilesen hic
807
+ * yazilmamis. Yetenek yazilmis, baglanmamis.
808
+ *
809
+ * ⚠️ Somut sonuc: Customer ve LocalAdmin konsollarinda bir aksiyonun sonucunu
810
+ * kullanicilara soyleyen HICBIR yuzey yok (toast · dialog · onay: 0 dosya).
811
+ * Kaydettim mi, kaydetmedim mi — ekran cevap vermiyor.
812
+ *
813
+ * 📌 AdminPanel ve PrivateAPI bugun PrimeNG `MessageService` kullaniyor
814
+ * (45 ve 18 dosya). Onlar BU SURUMDE gocurulmedi; iki farkli yigin bilerek
815
+ * yan yana duruyor ve gocun hedefi burasi.
816
+ */
817
+ declare class VpToastService {
818
+ /** Varsayilan otomatik kapanma. Politika `vpAutoDismissMs` icinde. */
819
+ private static readonly DEFAULT_DISMISS_MS;
820
+ private readonly stack;
821
+ /** Kabuk bunu `vp-toast`'a baglar. */
822
+ readonly toasts: i0.Signal<VpToast[]>;
823
+ /**
824
+ * ⚠️ Zamanlayicilar kimlige gore tutuluyor: ayni bildirim iki kez
825
+ * zamanlanirsa ilki bosa doner ve mesaj beklenenden erken kaybolur.
826
+ */
827
+ private readonly timers;
828
+ private sequence;
829
+ constructor();
830
+ /**
831
+ * Bildirim gosterir ve kimligini dondurur.
832
+ *
833
+ * Kimlik disaridan verilebilir; ayni kimlikle ikinci cagri mesaji
834
+ * **degistirir**, yigina ikinci bir satir eklemez. Tekrarlayan bir hata
835
+ * (baglanti koptu gibi) ekrani doldurmasin diye.
836
+ */
837
+ show(toast: Omit<VpToast, 'id'> & {
838
+ id?: string;
839
+ }): string;
840
+ info(message: string): string;
841
+ success(message: string): string;
842
+ warning(message: string): string;
843
+ /** 🔴 Hata kendiliginden KAPANMAZ — politika `vpAutoDismissMs`'te. */
844
+ danger(message: string): string;
845
+ dismiss(id: string): void;
846
+ clear(): void;
847
+ private schedule;
848
+ private cancel;
849
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpToastService, never>;
850
+ static ɵprov: i0.ɵɵInjectableDeclaration<VpToastService>;
851
+ }
852
+
853
+ /**
854
+ * GlobalLayers — paket 17 §6.1, **P0**.
855
+ *
856
+ * Kabugun ustunde duran katmanlar: bildirim yigini ve yukleme ortusu.
857
+ *
858
+ * ## Neden tek bir barindirici
859
+ *
860
+ * 🔴 Bildirim bolgesi HER ZAMAN DOM'da durmak zorunda (WCAG 2.2 · 4.1.3):
861
+ * `aria-live` sonradan eklenirse ekran okuyucu **ilk mesaji kacirir**.
862
+ * Sayfa basina koymak bu garantiyi bozar — kabukta bir kez durmasi sart.
863
+ *
864
+ * ⚠️ Yukleme ortusu `aria-busy` ile isaretleniyor ve odagi CALMIYOR. Ortu
865
+ * odaklanabilir olsaydi klavye kullanicisi gecici bir engelin icine
866
+ * hapsolurdu; is bitince odagin nereye dondugu de belirsizlesirdi.
867
+ *
868
+ * 📌 Dialog barindiricisi burada DEGIL: `vp-dialog` her cagrida farkli icerik
869
+ * yansitiyor ve kabukta tek bir ornek tutmak, icerigi uzaktan enjekte etmeyi
870
+ * gerektirirdi. Onay akislari `vp-confirm` ile cagiran ekranda kalir.
871
+ */
872
+ declare class VpGlobalLayersComponent {
873
+ protected readonly toastService: VpToastService;
874
+ /** Tam ekran yukleme ortusu. Uygulama acar/kapatir. */
875
+ loading: boolean;
876
+ loadingLabel: string;
877
+ /**
878
+ * Aksiyonlu bildirimde dugmeye basildi.
879
+ *
880
+ * ⚠️ Bildirim burada KAPATILMIYOR: aksiyonun sonucu (basarili/basarisiz)
881
+ * cagiran tarafta belli oluyor ve mesaji erken kaldirmak, kullaniciyi
882
+ * ne oldugunu bilmeden birakirdi.
883
+ */
884
+ readonly action: EventEmitter<string>;
885
+ protected actioned(id: string): void;
886
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpGlobalLayersComponent, never>;
887
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpGlobalLayersComponent, "vp-global-layers", never, { "loading": { "alias": "loading"; "required": false; }; "loadingLabel": { "alias": "loadingLabel"; "required": false; }; }, { "action": "action"; }, never, never, true, never>;
888
+ }
889
+
890
+ /**
891
+ * Bildirim tetigi — paket 17 §6.1, **P0**.
892
+ *
893
+ * Ust cubukta okunmamis sayisi + acilir liste.
894
+ *
895
+ * 🔴 Bilesen veri KAYNAGI DEGIL. Liste ve okundu isaretleme disaridan geliyor;
896
+ * Customer'da `NotificationStore`, PrivateAPI'de baska bir kaynak var ve
897
+ * bunlarin birlestirilmesi ayri bir istir. Icerde ikinci bir liste tutmak, bu
898
+ * depoda tekrar eden "iki kaynak ayrisir" hatasini davet ederdi — tema
899
+ * kontrolunde tam olarak bu yasandi.
900
+ *
901
+ * ⚠️ Sayi `aria-label`'a YAZILIYOR. Yalniz gorsel bir rozet, ekran okuyucu
902
+ * kullanicisina "uc okunmamis bildirim var" bilgisini HIC vermez.
903
+ *
904
+ * 📌 PrimeNG `p-button` + `p-overlaybadge` + `p-popover` sarmalaniyor,
905
+ * kopyalanmiyor (paket 10 §6.2).
906
+ *
907
+ * 🔴 TUKETICI SARTI: uygulama `provideAnimationsAsync()` (ya da
908
+ * `provideNoopAnimations()`) cagirmak ZORUNDA. `p-popover` sentetik bir
909
+ * animasyon dinleyicisi kuruyor ve saglayici yoksa panel acilirken
910
+ * NG05105 ile duser — dugme gorunur, tiklayinca patlar. `p-menu` de ayni
911
+ * sarti tasiyor (`vp-user-menu`).
912
+ */
913
+ declare class VpNotificationTriggerComponent {
914
+ items: VpNotificationEntry[];
915
+ /** Okunmamis sayisi. Kaynak disarida; burada sayilmiyor. */
916
+ unread: number;
917
+ /**
918
+ * ⚠️ Rozette gosterilecek en buyuk sayi. Ustu `99+` olur — dort haneli bir
919
+ * sayi rozeti tasirir ve zaten "cok" disinda bir sey soylemez.
920
+ */
921
+ maxBadge: number;
922
+ title: string;
923
+ emptyLabel: string;
924
+ panelId: string;
925
+ readonly opened: EventEmitter<void>;
926
+ protected get badgeValue(): string;
927
+ /** 🔴 Sayi metne yazilir; rozet tek basina ekran okuyucuya bir sey demez. */
928
+ protected get ariaLabel(): string;
929
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpNotificationTriggerComponent, never>;
930
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpNotificationTriggerComponent, "vp-notification-trigger", never, { "items": { "alias": "items"; "required": false; }; "unread": { "alias": "unread"; "required": false; }; "maxBadge": { "alias": "maxBadge"; "required": false; }; "title": { "alias": "title"; "required": false; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; }; "panelId": { "alias": "panelId"; "required": false; }; }, { "opened": "opened"; }, never, never, true, never>;
931
+ }
932
+ interface VpNotificationEntry {
933
+ /** Kararli kimlik — `track` ve okundu isaretleme icin. */
934
+ id: string;
935
+ message: string;
936
+ /** Bicimlenmis zaman. Bicimleme cagirana ait: yerel ayar orada biliniyor. */
937
+ timeLabel?: string;
938
+ unread?: boolean;
939
+ }
940
+
941
+ /**
942
+ * Komut paleti — paket 17 §6.1, **P1**.
943
+ *
944
+ * Klavyeyle her yere gitme yuzeyi. Referans konsolun en belirgin "profesyonel"
945
+ * isaretlerinden biri; menuyu gozle taramak yerine adiyla cagirmak.
946
+ *
947
+ * 🔴 Bilesen ARAMA YAPMAZ. Sorgu disari bildirilir, sonuclar disaridan gelir.
948
+ * Icerde filtrelemek, her konsolun kendi kaynagini (menu · tarama · anahtar ·
949
+ * kullanici) tek bir naif `includes` ile ezmek olurdu; ustelik uzak arama
950
+ * geldiginde iki kaynak ayrisirdi — bu depoda tekrar eden hata.
951
+ *
952
+ * ⚠️ Acilis kisayolunu da BU BILESEN DINLEMEZ. Global klavye dinleyicisi
953
+ * kabugun isi: hangi tuşun hangi ekranda yakalanacagi uygulamaya gore degisir
954
+ * ve bir bilesenin `document`'e baglanmasi, iki palet acildiginda iki
955
+ * dinleyici demektir.
956
+ *
957
+ * 📌 PrimeNG `p-dialog` + `p-listbox` + `p-iconfield` sarmalaniyor,
958
+ * kopyalanmiyor (paket 10 §6.2). Odak yonetimi ve klavye gezinme oradan geliyor.
959
+ *
960
+ * 🔴 TUKETICI SARTI: `provideAnimationsAsync()` (ya da `provideNoopAnimations()`)
961
+ * cagrilmali; `p-dialog` sentetik animasyon dinleyicisi kuruyor.
962
+ */
963
+ declare class VpCommandPaletteComponent {
964
+ open: boolean;
965
+ /** Sorgu metni — durum cagiranda. */
966
+ query: string;
967
+ /** Sonuclar. Filtreleme cagiranin isi. */
968
+ items: VpCommandItem[];
969
+ title: string;
970
+ placeholder: string;
971
+ emptyLabel: string;
972
+ listId: string;
973
+ readonly queryChange: EventEmitter<string>;
974
+ readonly picked: EventEmitter<VpCommandItem>;
975
+ readonly closed: EventEmitter<void>;
976
+ protected readonly panelClass = "vp-command-palette-panel";
977
+ protected onVisibleChange(visible: boolean): void;
978
+ /**
979
+ * ⚠️ Secim sonrasi palet KAPATILMIYOR — kapatma cagirana ait.
980
+ *
981
+ * Bazi komutlar gezinme (kapanmali), bazilari yerinde bir eylem (acik
982
+ * kalabilir). Burada kapatmak, ikinci turu imkansiz kilardi.
983
+ */
984
+ protected onPick(item: VpCommandItem | null): void;
985
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpCommandPaletteComponent, never>;
986
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpCommandPaletteComponent, "vp-command-palette", never, { "open": { "alias": "open"; "required": false; }; "query": { "alias": "query"; "required": false; }; "items": { "alias": "items"; "required": false; }; "title": { "alias": "title"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; }; "listId": { "alias": "listId"; "required": false; }; }, { "queryChange": "queryChange"; "picked": "picked"; "closed": "closed"; }, never, never, true, never>;
987
+ }
988
+ interface VpCommandItem {
989
+ /** Kararli kimlik — secim olayinda dondurulur. */
990
+ id: string;
991
+ label: string;
992
+ /** Isteğe bagli grup etiketi ("Gezinme", "Tarama"). */
993
+ group?: string;
994
+ }
995
+
996
+ /**
997
+ * Global arama tetigi — paket 17 §6.1, **P1**.
998
+ *
999
+ * Ust cubukta arama alani GIBI GORUNEN, ama aslinda komut paletini acan bir
1000
+ * dugme.
1001
+ *
1002
+ * ## Neden gercek bir `<input>` degil
1003
+ *
1004
+ * 🔴 Ust cubukta gercek bir metin kutusu olsaydi iki ayri yazma yuzeyi olurdu:
1005
+ * biri cubukta, biri palette. Kullanici cubuga yazmaya baslar, palet acilir ve
1006
+ * yazdigi kaybolur ya da iki yerde birden tutulur — **iki kaynak ayrisir**.
1007
+ * Referans konsol da bunu bir dugme olarak cozuyor.
1008
+ *
1009
+ * ⚠️ Bu yuzden ogenin rolu `button`, `searchbox` DEGIL. Ekran okuyucuya
1010
+ * "arama kutusu" demek, icine yazilabilecegini soylemek olurdu; yazilamiyor.
1011
+ *
1012
+ * 📌 Kisayol ipucu (`Ctrl K`) yalnizca **gorsel**: `aria-hidden`. Ekran
1013
+ * okuyucu icin kisayol bilgisi `aria-keyshortcuts` ile veriliyor — harfleri
1014
+ * tek tek okumak yerine.
1015
+ *
1016
+ * 📌 PrimeNG `p-button` sarmalaniyor, kopyalanmiyor (paket 10 §6.2).
1017
+ */
1018
+ declare class VpSearchTriggerComponent {
1019
+ label: string;
1020
+ /** Gorsel kisayol ipucu. Bos birakilirsa hic cizilmez. */
1021
+ hint: string;
1022
+ /**
1023
+ * ⚠️ `aria-keyshortcuts` bicimi standarttir (`Control+K`), gorsel ipucu ise
1024
+ * okunabilirlik icin serbest. Ikisini tek alandan uretmek, birini bozmadan
1025
+ * digerini degistirmeyi imkansiz kilardi.
1026
+ */
1027
+ keyShortcut: string;
1028
+ readonly opened: EventEmitter<void>;
1029
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpSearchTriggerComponent, never>;
1030
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpSearchTriggerComponent, "vp-search-trigger", never, { "label": { "alias": "label"; "required": false; }; "hint": { "alias": "hint"; "required": false; }; "keyShortcut": { "alias": "keyShortcut"; "required": false; }; }, { "opened": "opened"; }, never, never, true, never>;
1031
+ }
1032
+
1033
+ /**
1034
+ * Ikon + acilir menu — paket 17 §6.1 **P1** ("Help and documentation").
1035
+ *
1036
+ * ## Neden ayri bir "yardim menusu" bileseni yok
1037
+ *
1038
+ * 🔴 Yardim menusu, urun degistirici ve gelecekteki her "ikon + liste" tetigi
1039
+ * yapisal olarak AYNI SEY. Her biri icin ayri bir bilesen yazmak, bu depoda
1040
+ * surekli buldugum tekrarin yenisini uretmek olurdu — `app.topbar` uc repoda
1041
+ * 18/67/147 satira ayrismisti, sebebi tam olarak buydu.
1042
+ *
1043
+ * Yardim menusu = bu bilesen + yardim maddeleri. Ayri bir sinif degil.
1044
+ *
1045
+ * ⚠️ Urun degistirici AYRI (`vp-product-switcher`) cunku orada ek bir semantik
1046
+ * var: hangi urunde oldugun `aria-current` ile soylenmeli. Bu bilesende oyle
1047
+ * bir kavram yok ve zorla eklemek ikisini de bulanik yapardi.
1048
+ *
1049
+ * 📌 WCAG 3.2.6 (Consistent Help): yardim ayni yerde, ayni sirada durmali.
1050
+ * Kabuk bu tetigi ust cubukta sabit tutar; madde listesi uygulamadan gelir.
1051
+ *
1052
+ * 🔴 TUKETICI SARTI: `provideAnimationsAsync()` cagrilmali (`p-menu`).
1053
+ */
1054
+ declare class VpMenuButtonComponent {
1055
+ icon: string;
1056
+ /**
1057
+ * 🔴 ZORUNLU. Yalniz ikon tasiyan bir dugme, etiketi olmadan ekran okuyucu
1058
+ * icin "dugme" diye okunur — hangi dugme oldugu soylenmez.
1059
+ */
1060
+ ariaLabel: string;
1061
+ items: MenuItem[];
1062
+ menuId: string;
1063
+ readonly opened: EventEmitter<void>;
1064
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpMenuButtonComponent, never>;
1065
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpMenuButtonComponent, "vp-menu-button", never, { "icon": { "alias": "icon"; "required": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": true; }; "items": { "alias": "items"; "required": false; }; "menuId": { "alias": "menuId"; "required": false; }; }, { "opened": "opened"; }, never, never, true, never>;
1066
+ }
1067
+
1068
+ /**
1069
+ * Urun degistirici — paket 17 §6.1, **P1**.
1070
+ *
1071
+ * Virusis konsollari arasinda gecis: AdminPanel · LocalAdmin · PrivateAPI ·
1072
+ * Customer. Mikro frontend'in gerekcesi buydu — dort ayri uygulama, tek urun.
1073
+ *
1074
+ * ## Neden `p-menu` degil `p-popover`
1075
+ *
1076
+ * 🔴 `p-menu` maddelere `aria-current` koymayi desteklemiyor; model nesnesi
1077
+ * boyle bir alan tasimiyor. Hangi urunde oldugun **soylenmek zorunda**: dort
1078
+ * konsol ayni kabugu paylasiyor ve ayni gorunuyor, o yuzden "neredeyim"
1079
+ * sorusunun cevabi gorsel bir vurgudan ibaret kalamaz.
1080
+ *
1081
+ * ⚠️ Mevcut urun listede KALIYOR, cikarilmiyor. Cikarsaydik liste her konsolda
1082
+ * farkli uzunlukta olur ve kas hafizasi bozulurdu; ustelik "neredeyim"
1083
+ * bilgisini de kaybederdik.
1084
+ *
1085
+ * 📌 Gecis bir GEZINME. Bilesen `href` uretmiyor, secimi disari bildiriyor:
1086
+ * konsollar ayri kokenlerde (`app.virusis.com`, panel adresleri) ve adres
1087
+ * uretimi ortama gore degisiyor — burada sabitlemek yanlis olurdu.
1088
+ *
1089
+ * 🔴 TUKETICI SARTI: `provideAnimationsAsync()` cagrilmali (`p-popover`).
1090
+ */
1091
+ declare class VpProductSwitcherComponent {
1092
+ products: VpProduct[];
1093
+ /** Su an acik olan konsolun kimligi. */
1094
+ currentId: string | null;
1095
+ title: string;
1096
+ panelId: string;
1097
+ readonly selected: EventEmitter<VpProduct>;
1098
+ protected get currentLabel(): string;
1099
+ protected get ariaLabel(): string;
1100
+ /**
1101
+ * ⚠️ Bulundugun urune tiklamak olay YAYMAZ: ayni yere gezinmek sayfayi
1102
+ * bosuna yeniden yukler ve kullaniciya hicbir sey soylemez.
1103
+ */
1104
+ protected pick(product: VpProduct): void;
1105
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpProductSwitcherComponent, never>;
1106
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpProductSwitcherComponent, "vp-product-switcher", never, { "products": { "alias": "products"; "required": false; }; "currentId": { "alias": "currentId"; "required": false; }; "title": { "alias": "title"; "required": false; }; "panelId": { "alias": "panelId"; "required": false; }; }, { "selected": "selected"; }, never, never, true, never>;
1107
+ }
1108
+ interface VpProduct {
1109
+ id: string;
1110
+ label: string;
1111
+ /** Kisa ayirt edici cumle ("Musteri konsolu"). */
1112
+ description?: string;
1113
+ }
1114
+
1115
+ /**
1116
+ * Baglam arac cubugu — paket 17 §6.1, **P1**.
1117
+ *
1118
+ * Sayfa basligi ile icerik arasinda duran, o EKRANA ait eylem ve filtre seridi:
1119
+ * toplu secim sayisi, disa aktar, yenile, gorunum secici.
1120
+ *
1121
+ * ## Neden sayfa basliginin bir parcasi degil
1122
+ *
1123
+ * 🔴 Sayfa basligi (`vp-page-header`) SABIT bilgi tasir: ekranin adi ve birincil
1124
+ * eylemi. Baglam cubugu ise DEGISKEN durumu tasir — "3 satir secili", "filtre
1125
+ * uygulandi". Ikisini birlestirmek, secim degistikce basligin ziplamasi demek
1126
+ * olurdu ve ekran okuyucu her seferinde baslik bolgesini yeniden duyururdu.
1127
+ *
1128
+ * ⚠️ Cubuk BOSKEN CIZILMIYOR. Bos bir serit, dikey alani sebepsiz yer ve
1129
+ * kullaniciya "burada bir sey olmali ama yok" hissi verir.
1130
+ *
1131
+ * 📌 `role="toolbar"` ve `aria-label` PrimeNG'den geliyor. Icerik yuvalari
1132
+ * uygulamada kaliyor: hangi eylemin nerede duracagi ekrana gore degisir ve
1133
+ * burada sabitlemek her ekrani ayni kaliba sokardi.
1134
+ *
1135
+ * 📌 PrimeNG `p-toolbar` sarmalaniyor, kopyalanmiyor (paket 10 §6.2).
1136
+ */
1137
+ declare class VpContextToolbarComponent {
1138
+ /**
1139
+ * ⚠️ Varsayilan `false`. Bos bir serit dikey alani sebepsiz yer; cubuk
1140
+ * gosterilecek bir sey oldugunda acilir.
1141
+ */
1142
+ visible: boolean;
1143
+ /** 🔴 Ekran okuyucu icin ZORUNLU: sayfada birden fazla arac cubugu olabilir. */
1144
+ label: string;
1145
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpContextToolbarComponent, never>;
1146
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpContextToolbarComponent, "vp-context-toolbar", never, { "visible": { "alias": "visible"; "required": false; }; "label": { "alias": "label"; "required": false; }; }, {}, never, ["[start]", "[center]", "[end]"], true, never>;
1147
+ }
1148
+
1149
+ /**
1150
+ * Kosul motoru — paket 16 · G4.
1151
+ *
1152
+ * 🔴 Yetki ve kosul FARKLI eksenler (analiz §1.8):
1153
+ * yetki = "yapabilir mi" -> yetkisiz madde GORUNMEZ
1154
+ * kosul = "plani destekliyor mu" -> gorunur ama DEVRE DISI + sebep
1155
+ *
1156
+ * Kural (§1.5): **gorunmeyen ozellik satilamaz.** Kullanicinin erisemedigi ozellik
1157
+ * gorunur olmali, neden erisemedigi yazmali. `hide` yalnizca ILGISIZ maddeler icin
1158
+ * (LocalAdmin maddesi Customer'da gorunmez — satin alinabilir bir sey degil).
1159
+ */
1160
+ type VpMenuConditionKind = 'plan' | 'quota' | 'feature' | 'role';
1161
+ interface VpMenuCondition {
1162
+ kind: VpMenuConditionKind;
1163
+ /** Tek deger veya virgulle ayrilmis kabul edilenler: `flex` · `flex,starter` */
1164
+ key: string;
1165
+ /** Varsayilan `disable` — bkz. §1.5. */
1166
+ onFail?: 'disable' | 'hide';
1167
+ }
1168
+ interface VpQuotaState {
1169
+ used: number;
1170
+ /** `0` veya negatif = sinirsiz. */
1171
+ limit: number;
1172
+ }
1173
+ /**
1174
+ * Kosul kaynaklari. Analiz riski: *"Kosullar tek `/Auth/Me` yanitindan cozulur;
1175
+ * ek istek yok."* — bu nesne o yanittan doldurulur.
1176
+ */
1177
+ interface VpMenuCapabilities {
1178
+ plans?: string[];
1179
+ features?: string[];
1180
+ roles?: string[];
1181
+ quotas?: Record<string, VpQuotaState>;
1182
+ }
1183
+ interface VpConditionalMenuItem extends VpMenuItem {
1184
+ condition?: VpMenuCondition;
1185
+ }
1186
+ type VpConditionDescriber = (condition: VpMenuCondition, capabilities: VpMenuCapabilities) => string;
1187
+ declare const defaultConditionDescriber: VpConditionDescriber;
1188
+ /**
1189
+ * Kosul saglaniyor mu.
1190
+ *
1191
+ * ⚠️ `plan` bir SIRALAMA degil, KUME uyelugudir. Kilitli karar geregi yalniz iki
1192
+ * tarife var (Starter sabit $49 · Flex metered) ve hicbiri digerini kapsamiyor;
1193
+ * "flex >= starter" gibi bir siralama uydurmak yanlis kapi acardi. Birden fazla
1194
+ * tarife kabul ediliyorsa `key` virgulle yazilir.
1195
+ */
1196
+ declare function isConditionMet(condition: VpMenuCondition, capabilities: VpMenuCapabilities): boolean;
1197
+ /**
1198
+ * Menu maddelerini yetki + kosul eksenlerine gore cozer.
1199
+ *
1200
+ * | Yetki | Kosul | Sonuc |
1201
+ * |:-----:|:-----:|-------|
1202
+ * | ❌ | — | **Gorunmez** — yetkisiz kullaniciya varligi soylenmez |
1203
+ * | ✅ | ❌ `disable` | Gorunur, devre disi, **sebep yazili** |
1204
+ * | ✅ | ❌ `hide` | Gorunmez (ilgisiz madde) |
1205
+ * | ✅ | ✅ | Aktif |
1206
+ */
1207
+ declare function resolveMenuConditions(items: ReadonlyArray<VpConditionalMenuItem>, capabilities: VpMenuCapabilities, describe?: VpConditionDescriber): VpMenuItem[];
1208
+
1209
+ interface VpColumn {
1210
+ field: string;
1211
+ header: string;
1212
+ sortable?: boolean;
1213
+ width?: string;
1214
+ /**
1215
+ * Dar ekranda gizlenme onceligi. Yuksek sayi = once gizlenir.
1216
+ * Verilmezse gizlenmez.
1217
+ */
1218
+ hidePriority?: number;
1219
+ }
1220
+ /** Tablo veri istedigi — `PagedRequest` ile ayni sekil. */
1221
+ interface VpTableLoadEvent {
1222
+ page: number;
1223
+ size: number;
1224
+ sort?: string;
1225
+ order?: SortOrder;
1226
+ }
1227
+
1228
+ /**
1229
+ * Toplu aksiyon sozlesmesi — paket 08 · G7 (T8 formati).
1230
+ */
1231
+ interface VpBulkAction {
1232
+ code: string;
1233
+ label: string;
1234
+ /**
1235
+ * Geri alinamaz aksiyon. `true` ise tek tikla calismaz: bilesen once
1236
+ * onay ister (bkz. `VpDataTableComponent.requestBulkAction`).
1237
+ */
1238
+ danger?: boolean;
1239
+ }
1240
+ interface VpBulkRequest {
1241
+ code: string;
1242
+ /** Secili satirlarin anahtarlari — `rowKey` alanindan okunur. */
1243
+ keys: string[];
1244
+ }
1245
+ interface VpBulkFailure {
1246
+ key: string;
1247
+ /** Kullaniciya gosterilecek sebep. Bos birakilmamali. */
1248
+ reason: string;
1249
+ }
1250
+ /**
1251
+ * Toplu aksiyon sonucu.
1252
+ *
1253
+ * 🔴 **Kismi basari gizlenemez.** 40 satirdan 37'si silinip 3'u basarisiz olduysa
1254
+ * "Silindi" demek yalan, "Hata" demek de yalan. Iki liste de tasinir; bilesen
1255
+ * ikisini de gosterir.
1256
+ *
1257
+ * Basarisiz olanlar **anahtar + sebep** ile gelir: "3 kayit silinemedi" tek basina
1258
+ * kullaniciya hicbir sey yaptirmaz — hangisi ve neden gerekir.
1259
+ */
1260
+ interface VpBulkResult {
1261
+ code: string;
1262
+ succeeded: string[];
1263
+ failed: VpBulkFailure[];
1264
+ }
1265
+ declare function isPartialFailure(result: VpBulkResult | null): boolean;
1266
+
1267
+ /**
1268
+ * CSV uretimi — paket 08 · G10.
1269
+ *
1270
+ * Saf fonksiyon: DOM yok, indirme yok. Indirme uygulamanin isi (dosya adi,
1271
+ * izin, sunucu tarafi export secimi ona ait).
1272
+ */
1273
+ interface VpCsvOptions {
1274
+ /**
1275
+ * Ayrac. Varsayilan `;`.
1276
+ *
1277
+ * ⚠️ Turkce Windows/Excel yerelinde liste ayraci noktali virguldur; `,` ile
1278
+ * uretilen dosya **tek sutunda** acilir ve kullanici "export bozuk" der.
1279
+ * Farkli bir tuketici (pandas, `csv` modulu) icin `,` verilebilir.
1280
+ */
1281
+ delimiter?: string;
1282
+ /**
1283
+ * UTF-8 BOM eklensin mi. Varsayilan `true`.
1284
+ *
1285
+ * 🔴 BOM olmadan Excel dosyayi yerel kod sayfasiyla acar ve Turkce karakterler
1286
+ * bozulur (`ğ ş İ ç` -> mojibake). Kabul kriteri "kodlama (Turkce karakter)"
1287
+ * tam olarak bunu olcuyor.
1288
+ */
1289
+ bom?: boolean;
1290
+ newline?: string;
1291
+ }
1292
+ declare const UTF8_BOM = "\uFEFF";
1293
+ /**
1294
+ * Satirlari CSV metnine cevirir.
1295
+ *
1296
+ * Basliklar `VpColumn.header` — kullanici ekranda ne goruyorsa dosyada da onu
1297
+ * gorur. Alan adi (`field`) yazilsaydi `createdAtUtc` gibi ic isimler sizardi.
1298
+ */
1299
+ declare function toCsv(rows: ReadonlyArray<Record<string, unknown>>, columns: ReadonlyArray<VpColumn>, options?: VpCsvOptions): string;
1300
+ /**
1301
+ * Disa aktarma kapsami.
1302
+ *
1303
+ * 🔴 Server-side sayfali bir tabloda ekranda 25 satir vardir; tablo 4,7M satir
1304
+ * olabilir. "Disa aktar" dugmesinin sessizce 25 satir vermesi kullaniciyi
1305
+ * yanlis veriyle birakir — ve bunu fark etmesi zordur.
1306
+ *
1307
+ * Bu yuzden kapsam **acikca** tasinir; bileseni cagiran hangi kapsami
1308
+ * destekledigine karar verir ve etiketi ona gore yazar.
1309
+ */
1310
+ type VpExportScope = 'page' | 'all';
1311
+ interface VpExportRequest {
1312
+ scope: VpExportScope;
1313
+ /** Ekrandaki kolon sirasi/gorunurlugu — dosya ekranla ayni olmali. */
1314
+ columns: VpColumn[];
1315
+ }
1316
+
1317
+ /**
1318
+ * Kolon gorunurlugu + sirasi — paket 08 · G5.
1319
+ *
1320
+ * Kabul kriteri: **"Kolon gorunurlugu ve saved view tercihi kalicidir."**
1321
+ */
1322
+ interface VpTableColumnPrefs {
1323
+ /** Kullanicinin GIZLEDIGI kolonlar. */
1324
+ hidden: string[];
1325
+ /** Kullanicinin sectigi sira. Listede olmayan kolonlar sona eklenir. */
1326
+ order: string[];
1327
+ }
1328
+ interface VpTablePrefsStore {
1329
+ read(key: string): VpTableColumnPrefs | null;
1330
+ write(key: string, prefs: VpTableColumnPrefs): void;
1331
+ }
1332
+ /**
1333
+ * Kalicilik **uygulamadan** gelir.
1334
+ *
1335
+ * 🔴 Neden token: tasarim sistemi depolamaya karar vermemeli — bir uygulama
1336
+ * `localStorage`, digeri kullanici profili (backend `UserViews`, paket 08 · G6)
1337
+ * kullanmak isteyebilir. Bilesenin icine `localStorage` gomulseydi ikincisi
1338
+ * imkansiz olurdu.
1339
+ *
1340
+ * Varsayilan `localStorage`: varsayilan olmasaydi tercih "birileri baglayana
1341
+ * kadar" her yenilemede sifirlanirdi.
1342
+ */
1343
+ declare const VP_TABLE_PREFS_STORE: InjectionToken<VpTablePrefsStore>;
1344
+ declare function createLocalStoragePrefsStore(): VpTablePrefsStore;
1345
+ /**
1346
+ * Kayitli tercihi GUNCEL kolon tanimiyla uzlastirir.
1347
+ *
1348
+ * 🔴 Kayitli tercih tek dogru kaynak DEGILDIR.
1349
+ *
1350
+ * Klasik hata: kaydedilmis liste dogrudan kullanilir; koda sonradan eklenen bir
1351
+ * kolon o listede olmadigi icin **hicbir zaman gorunmez**. Kullanici yeni ozelligi
1352
+ * goremez ve nedenini bilemez; hata "eksik ozellik" gibi gorunur.
1353
+ *
1354
+ * Kural: tanimdaki her kolon sonuca girer.
1355
+ * - Kayitli sirada olanlar o sirayla,
1356
+ * - kayitta OLMAYANLAR (yeni kolonlar) sona ve **gorunur** olarak.
1357
+ * - Kayitta olup tanimda olmayanlar (silinmis kolon) atilir.
1358
+ */
1359
+ declare function reconcileColumnOrder(columns: VpColumn[], prefs: VpTableColumnPrefs | null): VpColumn[];
1360
+ /**
1361
+ * Gorunur kolonlar.
1362
+ *
1363
+ * 🔴 **Hicbir zaman bos donmez.** Kullanici tum kolonlari gizlerse tablo bos bir
1364
+ * kabuga doner ve geri donus yolu kalmaz. Boyle bir tercih uzlastirmada
1365
+ * yok sayilir; en az bir kolon her zaman gorunur.
1366
+ */
1367
+ declare function visibleColumns(ordered: VpColumn[], prefs: VpTableColumnPrefs | null): VpColumn[];
1368
+
1369
+ /**
1370
+ * Kayitli gorunumler — paket 08 · G6.
1371
+ *
1372
+ * ## 🔴 T4'un cevabi: `UserViews` tablosu UYGUN DEGIL
1373
+ *
1374
+ * Analiz "saved views (backend: `UserViews`)" diyordu. Olculdu (2026-08-14):
1375
+ * `UserViews` bir **ziyaretci takip** tablosu —
1376
+ * `TrackUser(deviceId)` · `HasUserVisitedBefore()` · `EnsureTrackingCookie()`.
1377
+ * Tablo goruntusuyle hicbir ilgisi yok.
1378
+ *
1379
+ * Backend kaliciligi icin YENI bir tablo gerekiyor; bu ayri bir sema karari.
1380
+ * O karar beklemesin diye gorunumler ayni <see cref="VpSavedViewStore"/>
1381
+ * soyutlamasi uzerinden yasiyor: bugun `localStorage`, yarin backend — bilesen
1382
+ * degismeden.
1383
+ */
1384
+ interface VpSavedView {
1385
+ /** Kullanicinin verdigi ad — anahtar olarak da kullanilir. */
1386
+ name: string;
1387
+ columns: VpTableColumnPrefs;
1388
+ sort?: string;
1389
+ order?: SortOrder;
1390
+ pageSize?: number;
1391
+ }
1392
+ interface VpSavedViewStore {
1393
+ read(key: string): VpSavedView[];
1394
+ write(key: string, views: VpSavedView[]): void;
1395
+ }
1396
+ declare function createLocalStorageViewStore(): VpSavedViewStore;
1397
+ declare const VP_SAVED_VIEW_STORE: InjectionToken<VpSavedViewStore>;
1398
+ /**
1399
+ * Gorunumu listeye ekler veya AYNI ADLIYI degistirir.
1400
+ *
1401
+ * 🔴 Ayni ad iki kez kaydedilebilseydi kullanici "Aylik rapor" adinda iki farkli
1402
+ * gorunum gorur ve hangisinin guncel oldugunu bilemezdi. Ad benzersiz; ayni ada
1403
+ * kaydetmek **ustune yazmaktir** ve cagiran bunu kullaniciya sorabilir.
1404
+ */
1405
+ declare function upsertView(views: ReadonlyArray<VpSavedView>, view: VpSavedView): VpSavedView[];
1406
+ declare function removeView(views: ReadonlyArray<VpSavedView>, name: string): VpSavedView[];
1407
+ declare function findView(views: ReadonlyArray<VpSavedView>, name: string): VpSavedView | null;
1408
+
1409
+ /**
1410
+ * Veri tablosu — paket 08 · G3.
1411
+ *
1412
+ * ## Neden var
1413
+ *
1414
+ * `dynamic-list.component.ts:28` `[lazy]` · `[totalRecords]` · `(onLazyLoad)`
1415
+ * kullanmiyordu; `getAll` tum satirlari cekiyordu. 89 entity ekraninin hepsi
1416
+ * o bilesene bagli. `ScanTimingEvents` 4.716.151 satir -> tarayici kilitleniyor.
1417
+ *
1418
+ * ## Kritik tasarim karari
1419
+ *
1420
+ * **`serverSide` VARSAYILAN `true`.** Client-side acik opt-in gerektirir.
1421
+ * Bugun tam tersiydi ve hata bu yuzden sessizce yayildi: kimse "server-side
1422
+ * acmayi" unutmadi, kimse "client-side'i kapatmayi" hatirlamadi.
1423
+ *
1424
+ * Veri getirme bu bilesenin isi DEGIL. `load` olayini yayar, ust bilesen
1425
+ * veriyi getirip `rows` + `total` olarak geri verir.
1426
+ */
1427
+ declare class VpDataTableComponent implements OnInit, OnChanges {
1428
+ /**
1429
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
1430
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
1431
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
1432
+ *
1433
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
1434
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
1435
+ */
1436
+ protected readonly iconSprite: VpIconSpriteService;
1437
+ columns: VpColumn[];
1438
+ rows: Record<string, unknown>[];
1439
+ /** Filtre uygulandiktan SONRAKI toplam — sayfalayici bunu kullanir. */
1440
+ total: number;
1441
+ /**
1442
+ * ⚠️ VARSAYILAN `true`. Client-side sayfalama **acik opt-in** gerektirir.
1443
+ * Bkz. sinif yorumu — hatanin sessizce yayilma nedeni bu varsayilanin tersiydi.
1444
+ */
1445
+ serverSide: boolean;
1446
+ pageSize: number;
1447
+ loading: boolean;
1448
+ error: string | null;
1449
+ /** Aktif filtre var mi — bos durum metnini degistirir. */
1450
+ hasActiveFilter: boolean;
1451
+ caption: string;
1452
+ totalLabel: string;
1453
+ loadingLabel: string;
1454
+ emptyLabel: string;
1455
+ emptyFilteredLabel: string;
1456
+ clearFiltersLabel: string;
1457
+ retryLabel: string;
1458
+ pagerLabel: string;
1459
+ prevLabel: string;
1460
+ nextLabel: string;
1461
+ /**
1462
+ * Tercihin kaydedilecegi anahtar.
1463
+ *
1464
+ * 🔴 Verilmezse tercih **kaydedilmez**. Otomatik bir anahtar uretilseydi
1465
+ * (or. rota veya kolon adlarindan) ayni sayfadaki iki tablo birbirinin
1466
+ * tercihini ezerdi; sessiz ve teshisi zor bir hata.
1467
+ */
1468
+ storageKey?: string;
1469
+ /** Opt-in: her tablo toplu aksiyon istemez. */
1470
+ selectable: boolean;
1471
+ /**
1472
+ * Satırı benzersiz kılan alan.
1473
+ *
1474
+ * 🔴 Seçim indeksle taşınsaydı sayfa değişince **başka satırlar** seçili
1475
+ * görünürdü — server-side tabloda satır dizisi her istekte yenilenir.
1476
+ */
1477
+ rowKey: string;
1478
+ bulkActions: VpBulkAction[];
1479
+ /** Üst bileşen işlem bitince doldurur; bileşen raporu gösterir. */
1480
+ bulkResult: VpBulkResult | null;
1481
+ bulkLabel: string;
1482
+ selectedLabel: string;
1483
+ clearSelectionLabel: string;
1484
+ selectPageLabel: string;
1485
+ selectRowLabel: string;
1486
+ confirmPrefix: string;
1487
+ confirmLabel: string;
1488
+ cancelLabel: string;
1489
+ succeededLabel: string;
1490
+ failedLabel: string;
1491
+ readonly bulkAction: EventEmitter<VpBulkRequest>;
1492
+ protected readonly selectedKeys: Set<string>;
1493
+ protected pendingAction: VpBulkAction | null;
1494
+ /** Opt-in. Kapalıyken ne sütun ne düğme render edilir. */
1495
+ expandable: boolean;
1496
+ /**
1497
+ * Detay içeriği üst bileşenden gelir (`$implicit` = satır).
1498
+ *
1499
+ * 🔴 Tasarım sistemi bir satırın "detayı"nın ne olduğunu bilemez — 89 entity
1500
+ * ekranının her biri farklı. Şablon verilmezse bilgilendirici bir metin çıkar,
1501
+ * boş bir kutu değil.
1502
+ */
1503
+ rowDetail: TemplateRef<{
1504
+ $implicit: Record<string, unknown>;
1505
+ }> | null;
1506
+ expandLabel: string;
1507
+ collapseLabel: string;
1508
+ expandColumnLabel: string;
1509
+ noDetailLabel: string;
1510
+ /**
1511
+ * Satır başına aksiyon şablonu — bağlam olarak satırı alır.
1512
+ *
1513
+ * 🔴 Neden ayrı bir sütun, `<tr>` tıklaması değil: satır klavye ve ekran
1514
+ * okuyucu için bir kontrol değildir. Tıklanabilir satır, fare kullanmayan
1515
+ * kullanıcı için erişilemez bir işlev demek. Şablon gerçek bir `button` ya da
1516
+ * `a` koyar ve odak sırası doğal kalır.
1517
+ *
1518
+ * Verilmezse sütun HİÇ çizilmiyor: boş bir sütun her satırda anlamsız bir
1519
+ * boşluk ve ekran okuyucuda adsız bir başlık üretirdi.
1520
+ */
1521
+ rowActions: TemplateRef<{
1522
+ $implicit: Record<string, unknown>;
1523
+ }> | null;
1524
+ /** Aksiyon sütununun başlığı. Boş bırakılmıyor — adsız sütun "sütun 5" diye okunur. */
1525
+ rowActionsHeader: string;
1526
+ protected readonly expandedKeys: Set<string>;
1527
+ /**
1528
+ * Desteklenen kapsamlar. Boş = düğme yok.
1529
+ *
1530
+ * 🔴 Kapsam gizlenemez: server-side tabloda ekranda 25 satır var, tablo 4,7M
1531
+ * olabilir. Düğmenin sessizce 25 satır vermesi kullanıcıyı yanlış veriyle
1532
+ * bırakır. Etiket kapsamı yazar.
1533
+ */
1534
+ exportScopes: VpExportScope[];
1535
+ exportPageLabel: string;
1536
+ exportAllLabel: string;
1537
+ readonly exportRequest: EventEmitter<VpExportRequest>;
1538
+ /**
1539
+ * Görünümlerin saklanacağı anahtar. Yoksa görünüm özelliği KAPALI.
1540
+ *
1541
+ * ⚠️ Backend kalıcılığı için yeni bir tablo gerekiyor: `UserViews` bir ziyaretçi
1542
+ * takip tablosu, tablo görünümüyle ilgisi yok (T4 ölçümü, 2026-08-14).
1543
+ */
1544
+ savedViewsKey?: string;
1545
+ viewsLabel: string;
1546
+ viewsPlaceholder: string;
1547
+ saveViewLabel: string;
1548
+ deleteViewLabel: string;
1549
+ /**
1550
+ * Ad sorma işi UYGULAMANIN. Varsayılan `window.prompt` çirkin ama çalışır;
1551
+ * varsayılan olmasaydı özellik "birileri bağlayana kadar" ölü kalırdı.
1552
+ */
1553
+ askViewName: () => string | null;
1554
+ readonly viewApplied: EventEmitter<VpSavedView>;
1555
+ protected savedViews: VpSavedView[];
1556
+ protected activeView: string;
1557
+ private readonly viewStore;
1558
+ columnPicker: boolean;
1559
+ columnsLabel: string;
1560
+ moveUpLabel: string;
1561
+ moveDownLabel: string;
1562
+ protected pickerOpen: boolean;
1563
+ protected orderedColumns: VpColumn[];
1564
+ protected visibleCols: VpColumn[];
1565
+ private prefs;
1566
+ private readonly prefsStore;
1567
+ private readonly cdr;
1568
+ /** Veri istegi. Ust bilesen `rows` + `total` ile yanit verir. */
1569
+ readonly load: EventEmitter<VpTableLoadEvent>;
1570
+ readonly clearFilters: EventEmitter<void>;
1571
+ page: number;
1572
+ protected sortField: string | null;
1573
+ protected sortOrder: SortOrder;
1574
+ protected readonly skeletonRows: number[];
1575
+ ngOnInit(): void;
1576
+ ngOnChanges(): void;
1577
+ /** Kullanicinin gormek istedigi kolon sayisi — son kolon kapatilamaz. */
1578
+ protected get visibleCount(): number;
1579
+ protected isVisible(field: string): boolean;
1580
+ setColumnVisible(field: string, visible: boolean): void;
1581
+ moveColumn(field: string, delta: number): void;
1582
+ private loadPrefs;
1583
+ private applyPrefs;
1584
+ private persist;
1585
+ get pageCount(): number;
1586
+ protected asSelectValue(event: Event): string;
1587
+ /** Görünüm seçilince kolon tercihi + sıralama + sayfa boyutu birlikte uygulanır. */
1588
+ applyView(name: string): void;
1589
+ saveViewPrompt(): void;
1590
+ deleteActiveView(): void;
1591
+ protected exportLabel(scope: VpExportScope): string;
1592
+ /** Dosya ekranla aynı olmalı: görünür kolonlar, kullanıcının sırasıyla. */
1593
+ requestExport(scope: VpExportScope): void;
1594
+ /** Detay satırı tüm sütunları kaplar — seçim/genişletme sütunları dahil. */
1595
+ protected get columnSpan(): number;
1596
+ protected isExpanded(row: Record<string, unknown>): boolean;
1597
+ toggleExpanded(row: Record<string, unknown>): void;
1598
+ protected keyOf(row: Record<string, unknown>): string;
1599
+ protected isSelected(row: Record<string, unknown>): boolean;
1600
+ toggleRow(row: Record<string, unknown>): void;
1601
+ protected get allOnPageSelected(): boolean;
1602
+ protected get someOnPageSelected(): boolean;
1603
+ /**
1604
+ * 🔴 Başlıktaki kutu **yalnız bu sayfayı** seçer.
1605
+ *
1606
+ * "Eşleşen tüm kayıtları seç" bilerek YOK: 4,7M satırlık bir tabloda
1607
+ * kullanıcının gördüğü 25 satır ile kastettiği milyonlar arasındaki fark
1608
+ * geri alınamaz bir toplu silmeye dönüşür. Kapsam her zaman görünür olmalı.
1609
+ */
1610
+ togglePageSelection(): void;
1611
+ clearSelection(): void;
1612
+ /** Tehlikeli aksiyon tek tıkla çalışmaz; önce onay ister. */
1613
+ requestBulkAction(action: VpBulkAction): void;
1614
+ confirmBulkAction(): void;
1615
+ private emitBulk;
1616
+ goToPage(target: number): void;
1617
+ toggleSort(field: string): void;
1618
+ protected emitLoad(): void;
1619
+ protected ariaSort(col: VpColumn): string | null;
1620
+ protected sortGlyph(field: string): string;
1621
+ protected cell(row: Record<string, unknown>, field: string): unknown;
1622
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpDataTableComponent, never>;
1623
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpDataTableComponent, "vp-data-table", never, { "columns": { "alias": "columns"; "required": true; }; "rows": { "alias": "rows"; "required": false; }; "total": { "alias": "total"; "required": false; }; "serverSide": { "alias": "serverSide"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "error": { "alias": "error"; "required": false; }; "hasActiveFilter": { "alias": "hasActiveFilter"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "totalLabel": { "alias": "totalLabel"; "required": false; }; "loadingLabel": { "alias": "loadingLabel"; "required": false; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; }; "emptyFilteredLabel": { "alias": "emptyFilteredLabel"; "required": false; }; "clearFiltersLabel": { "alias": "clearFiltersLabel"; "required": false; }; "retryLabel": { "alias": "retryLabel"; "required": false; }; "pagerLabel": { "alias": "pagerLabel"; "required": false; }; "prevLabel": { "alias": "prevLabel"; "required": false; }; "nextLabel": { "alias": "nextLabel"; "required": false; }; "storageKey": { "alias": "storageKey"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "rowKey": { "alias": "rowKey"; "required": false; }; "bulkActions": { "alias": "bulkActions"; "required": false; }; "bulkResult": { "alias": "bulkResult"; "required": false; }; "bulkLabel": { "alias": "bulkLabel"; "required": false; }; "selectedLabel": { "alias": "selectedLabel"; "required": false; }; "clearSelectionLabel": { "alias": "clearSelectionLabel"; "required": false; }; "selectPageLabel": { "alias": "selectPageLabel"; "required": false; }; "selectRowLabel": { "alias": "selectRowLabel"; "required": false; }; "confirmPrefix": { "alias": "confirmPrefix"; "required": false; }; "confirmLabel": { "alias": "confirmLabel"; "required": false; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; }; "succeededLabel": { "alias": "succeededLabel"; "required": false; }; "failedLabel": { "alias": "failedLabel"; "required": false; }; "expandable": { "alias": "expandable"; "required": false; }; "rowDetail": { "alias": "rowDetail"; "required": false; }; "expandLabel": { "alias": "expandLabel"; "required": false; }; "collapseLabel": { "alias": "collapseLabel"; "required": false; }; "expandColumnLabel": { "alias": "expandColumnLabel"; "required": false; }; "noDetailLabel": { "alias": "noDetailLabel"; "required": false; }; "rowActions": { "alias": "rowActions"; "required": false; }; "rowActionsHeader": { "alias": "rowActionsHeader"; "required": false; }; "exportScopes": { "alias": "exportScopes"; "required": false; }; "exportPageLabel": { "alias": "exportPageLabel"; "required": false; }; "exportAllLabel": { "alias": "exportAllLabel"; "required": false; }; "savedViewsKey": { "alias": "savedViewsKey"; "required": false; }; "viewsLabel": { "alias": "viewsLabel"; "required": false; }; "viewsPlaceholder": { "alias": "viewsPlaceholder"; "required": false; }; "saveViewLabel": { "alias": "saveViewLabel"; "required": false; }; "deleteViewLabel": { "alias": "deleteViewLabel"; "required": false; }; "askViewName": { "alias": "askViewName"; "required": false; }; "columnPicker": { "alias": "columnPicker"; "required": false; }; "columnsLabel": { "alias": "columnsLabel"; "required": false; }; "moveUpLabel": { "alias": "moveUpLabel"; "required": false; }; "moveDownLabel": { "alias": "moveDownLabel"; "required": false; }; }, { "bulkAction": "bulkAction"; "exportRequest": "exportRequest"; "viewApplied": "viewApplied"; "load": "load"; "clearFilters": "clearFilters"; }, never, never, true, never>;
1624
+ }
1625
+
1626
+ /**
1627
+ * Cekmece — paket 08 · G8 (tablo detayi) + paket 17 §6.1 GlobalLayers (kabuk).
1628
+ *
1629
+ * Bir satirin detayini **listeyi kaybetmeden** gostermek icin. Ayri bir sayfaya
1630
+ * gitmek baglami koparir: kullanici geri donunce sayfa/siralama/secim durumunu
1631
+ * kaybeder.
1632
+ *
1633
+ * ## 2026-08-27 — elle yazilmis kopyadan PrimeNG sarmalayicisina
1634
+ *
1635
+ * 🔴 Onceki surum 155 satirlik **elle yazilmis** bir cekmeceydi: kendi ortusu,
1636
+ * kendi odak tuzagi, kendi ESC islemesi. Paket 10 §6.2 karari bunu acikca
1637
+ * yasakliyor — `vp-*` PrimeNG'yi **sarmalar, kopyalamaz**. Olculdu: paket
1638
+ * PrimeNG'yi bu oturuma kadar hic import etmiyordu.
1639
+ *
1640
+ * ⚠️ Kopyanin bedeli soyut degildi: odak tuzagi · kaydirma kilidi · ust uste
1641
+ * binen katman sirasi · ekran okuyucu ilani — hepsi PrimeNG'de zaten cozulmus
1642
+ * ve surekli bakim goren seyler. Kendi yazdigimiz surum yalnizca test
1643
+ * ettigimiz kadarini dogru yapiyordu.
1644
+ *
1645
+ * 🔴 TUKETICI SARTI: uygulama `provideAnimationsAsync()` (ya da
1646
+ * `provideNoopAnimations()`) cagirmak ZORUNDA. `p-drawer` sentetik animasyon
1647
+ * dinleyicisi kuruyor; saglayici yoksa cekmece acilirken NG05105 ile duser.
1648
+ */
1649
+ declare class VpDrawerComponent implements AfterViewChecked, OnDestroy {
1650
+ private readonly host;
1651
+ /**
1652
+ * 🔴 Ornek basina BENZERSIZ sinif.
1653
+ *
1654
+ * Olculdu (2026-08-27): `p-drawer` modal kipte paneli **`<body>`'ye
1655
+ * tasiyor** — bilesenin kendi DOM agacinda DEGIL. Ilk surumum paneli
1656
+ * `host.querySelector('.p-drawer')` ile ariyordu ve HICBIR ZAMAN bulmuyordu;
1657
+ * rol duzeltmesi ve odak tasima sessizce hic calismadi. Testlerden biri yine
1658
+ * de geciyordu, cunku belgede baska bir ornegin panelini buluyordu — yani
1659
+ * kapi yanlis seyi olcuyordu.
1660
+ *
1661
+ * Benzersiz sinif, "belgedeki herhangi bir cekmece" ile "BU cekmece"
1662
+ * arasindaki farki kesinlestiriyor.
1663
+ */
1664
+ protected readonly panelClass: string;
1665
+ private get panel();
1666
+ open: boolean;
1667
+ title: string;
1668
+ closeLabel: string;
1669
+ /** Kabuk yuvasi olarak kullanildiginda `left` de olabilir. */
1670
+ position: 'left' | 'right' | 'top' | 'bottom';
1671
+ width: string;
1672
+ /**
1673
+ * Maske + odak hapsi. Kapatilirsa cekmece gercekten bir yan bolgedir ve
1674
+ * `complementary` semantigi dogru olur.
1675
+ */
1676
+ modal: boolean;
1677
+ readonly closed: EventEmitter<void>;
1678
+ /**
1679
+ * 🔴 `visible` tek yonlu baglaniyor ve kapanma disari bildiriliyor.
1680
+ *
1681
+ * Iki yonlu baglasaydik cekmece kendi durumunu tutardi ve `open` girdisiyle
1682
+ * ayrisirdi — bu depoda tekrar eden "iki kaynak ayrisir" hatasi. Durum
1683
+ * cagiranda; burasi yalnizca gosterir ve haber verir.
1684
+ */
1685
+ protected onVisibleChange(visible: boolean): void;
1686
+ /**
1687
+ * 🔴 PrimeNG'nin verdigi semantik DUZELTILIYOR.
1688
+ *
1689
+ * Olculdu (2026-08-27): `p-drawer` panele `role="complementary"` YAZIYOR ve
1690
+ * bunu sabit tutuyor — `aria-modal` hic yok, degistirecek bir girdi de yok.
1691
+ * Maskeli bir cekmece icin bu yanlis: ekran okuyucu kullanicisina sayfanin
1692
+ * geri kalaninin erisilemez oldugu SOYLENMIYOR, sadece "yan bolge"ye
1693
+ * girdigi soyleniyor.
1694
+ *
1695
+ * Elle yazilmis onceki surumde `role="dialog"` + `aria-modal="true"` vardi.
1696
+ * Sarmalamak, calisan bir erisilebilirlik davranisini kaybetmek anlamina
1697
+ * gelemez — sarmalayicinin isi tam olarak budur: kutuphanenin makinesini
1698
+ * (odak · kaydirma kilidi · maske · katman sirasi) al, kendi standardini
1699
+ * ustune koy.
1700
+ *
1701
+ * ⚠️ `modal` KAPALIYKEN dokunulmuyor: maskesiz bir cekmece gercekten bir
1702
+ * yan bolgedir ve orada `complementary` dogru cevaptir.
1703
+ */
1704
+ ngAfterViewChecked(): void;
1705
+ ngOnDestroy(): void;
1706
+ /** Cekmece acilmadan hemen once odakta olan oge. */
1707
+ private opener;
1708
+ private wasOpen;
1709
+ /**
1710
+ * 🔴 Odak GERI VERILIYOR — PrimeNG bunu yapmiyor.
1711
+ *
1712
+ * Olculdu (2026-08-27): `p-drawer` acilista `pAutoFocus` ile odagi iceri
1713
+ * tasiyor ama KAPANISTA geri vermiyor. Elle yazilmis onceki surum
1714
+ * veriyordu (`trap.restore()`).
1715
+ *
1716
+ * ⚠️ Kaybi somut: klavye kullanicisi cekmeceyi kapatinca odak `<body>`'ye
1717
+ * duser ve bir sonraki Tab kullaniciyi sayfanin en basina savurur — az once
1718
+ * uzerinde durdugu satira degil. Uzun bir tabloda bu, yeri kaybetmek demek.
1719
+ */
1720
+ private trackOpener;
1721
+ /**
1722
+ * 🔴 Odak ICERI TASINIYOR — PrimeNG bunu da guvenilir yapmiyor.
1723
+ *
1724
+ * Olculdu (2026-08-27): `p-drawer` kapatma dugmesine `pAutoFocus` veriyor
1725
+ * ama acilis girdiyle tetiklendiginde odak ACAN OGEDE kaliyor (dugmede
1726
+ * `autofocus` niteligi bile olusmuyor). Elle yazilmis onceki surum odagi
1727
+ * kapatma dugmesine tasiyordu.
1728
+ *
1729
+ * ⚠️ Kaybi somut: cekmece acilir, odak hala arkadaki listededir; Tab
1730
+ * kullaniciyi cekmecenin ICINE degil, maskeyle ortulmus ve okunamayan
1731
+ * icerige goturur.
1732
+ *
1733
+ * ⏱️ `setTimeout(0)`: PrimeNG panelin animasyonunu ve kendi odak denemesini
1734
+ * ayni turda yapiyor; ondan SONRA yazmak gerekiyor.
1735
+ */
1736
+ private focusInside;
1737
+ private restoreFocus;
1738
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpDrawerComponent, never>;
1739
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpDrawerComponent, "vp-drawer", never, { "open": { "alias": "open"; "required": false; }; "title": { "alias": "title"; "required": false; }; "closeLabel": { "alias": "closeLabel"; "required": false; }; "position": { "alias": "position"; "required": false; }; "width": { "alias": "width"; "required": false; }; "modal": { "alias": "modal"; "required": false; }; }, { "closed": "closed"; }, never, ["*"], true, never>;
1740
+ }
1741
+
1742
+ /**
1743
+ * Odak tuzagi — paket 08 · G8 (kaynak: `vp-dialog`, paket 06).
1744
+ *
1745
+ * `vp-dialog` bu davranisi zaten tasiyordu; `vp-drawer` da ayni seyi isteyince
1746
+ * kopyalamak yerine cikarildi. Ayni hata iki yerde duzeltilmek zorunda kalmasin.
1747
+ *
1748
+ * DOM'a bagli ama Angular'a bagli DEGIL — dogrudan test edilebilir.
1749
+ */
1750
+ declare function focusableElements(container: HTMLElement | null): HTMLElement[];
1751
+ interface VpFocusTrap {
1752
+ /** Acilista: mevcut odagi sakla, ilk odaklanabilir ogeye tasi. */
1753
+ capture(): void;
1754
+ /** Kapanista: odagi geldigi yere geri ver. */
1755
+ restore(): void;
1756
+ /** `Tab` / `Shift+Tab` dongusu — odak arkadaki sayfaya kacamaz. */
1757
+ handleTab(event: KeyboardEvent): void;
1758
+ readonly active: boolean;
1759
+ }
1760
+ declare function createFocusTrap(getContainer: () => HTMLElement | null): VpFocusTrap;
1761
+
1762
+ /**
1763
+ * Tarama ilerlemesinin sesli duyurusu.
1764
+ *
1765
+ * Paket 27 · G6 — canli bolge, duyuru **bir kez**.
1766
+ *
1767
+ * 🔴 Tarama ilerlemesi ekranda saniyede birkac kez degisiyor: yuzde artiyor,
1768
+ * asama adi degisiyor, kaynak sayaci ilerliyor. Bunu dogrudan bir `aria-live`
1769
+ * bolgesine baglamak, goze **bir animasyon** olan seyi kulaga **yuzlerce
1770
+ * cumle** yapiyor. Ekran okuyucu kullanicisi taramanin nerede oldugunu daha az
1771
+ * ogreniyor, cunku duyurular birbirini kesiyor ve arada gercekten onemli olan
1772
+ * ("tarama bitti", "tarama basarisiz") kayboluyor.
1773
+ *
1774
+ * ⚠️ Bu yuzden kural: **yuzde tek basina duyuru sebebi degil.** Duyuruyu
1775
+ * **asama degisimi** ve **bitis** tetikliyor. Yuzde gorsel olarak kaliyor —
1776
+ * kaldirilmiyor, yalnizca seslendirilmiyor.
1777
+ *
1778
+ * Saf: DOM yok, zamanlayici yok. Neyin duyurulacagina karar veriyor; nasil
1779
+ * gosterilecegi bileseninin isi.
1780
+ */
1781
+ type VpScanPhaseKind = 'running' | 'done' | 'failed';
1782
+ interface VpScanProgress {
1783
+ /** Asama kimligi — cevrilmis metin DEGIL. Metin degisince duyuru tekrarlamasin. */
1784
+ phase: string;
1785
+ /** Kullaniciya okunacak metin. */
1786
+ message: string;
1787
+ /** Gorsel ilerleme. Duyuruyu **tetiklemiyor**. */
1788
+ percent?: number;
1789
+ kind?: VpScanPhaseKind;
1790
+ }
1791
+ interface VpAnnouncement {
1792
+ message: string;
1793
+ /**
1794
+ * `assertive` yalniz **bitis** icin: kullaniciyi kesmek, ancak beklemenin
1795
+ * bittigini soylemek icin haklidir. Ara asamalar `polite`.
1796
+ */
1797
+ politeness: 'polite' | 'assertive';
1798
+ }
1799
+ interface VpScanAnnouncer {
1800
+ /** Yeni durum. Duyurulacak bir sey yoksa `null`. */
1801
+ next(progress: VpScanProgress | null | undefined): VpAnnouncement | null;
1802
+ reset(): void;
1803
+ }
1804
+ declare function createScanAnnouncer(): VpScanAnnouncer;
1805
+
1806
+ /**
1807
+ * Form alani sarmalayicisi — paket 05 · G7.
1808
+ *
1809
+ * Etiketi, ipucunu ve hatayi icindeki kontrole **erisilebilirlik baglariyla**
1810
+ * baglar: `for`/`id` · `aria-describedby` · `aria-invalid` · `aria-required`.
1811
+ *
1812
+ * Duzen kurali (paket 07): etiket USTTE, hata alan ALTINDA, tek satir.
1813
+ * Hata ozeti yalnizca sunucu hatasinda gosterilir — alan basina hata yeterli.
1814
+ *
1815
+ * ⚠️ **Devre disi ≠ salt-okunur.** Bu bilesen ikisini karistirmaz:
1816
+ * `disabled` -> su an yapilamaz (gecici; odaklanamaz)
1817
+ * `readonly` -> yetkiniz yok (kalici; odaklanir, kopyalanir, okunur)
1818
+ * Tuketici hangisini istiyorsa kontrole kendisi koyar; bu bilesen yalnizca
1819
+ * gorsel ayrimi saglar.
1820
+ */
1821
+ declare class VpFieldComponent implements AfterContentInit, OnChanges {
1822
+ label: string;
1823
+ hint: string | null;
1824
+ error: string | null;
1825
+ required: boolean;
1826
+ private readonly hostRef;
1827
+ private readonly cdr;
1828
+ private readonly seq;
1829
+ protected controlId: string;
1830
+ protected readonly hintId: string;
1831
+ protected readonly errorId: string;
1832
+ ngAfterContentInit(): void;
1833
+ ngOnChanges(): void;
1834
+ /**
1835
+ * Yansitilan kontrole erisilebilirlik niteliklerini baglar.
1836
+ *
1837
+ * Kontrol `ng-content` ile geldigi icin sablonda `[attr.*]` ile baglanamiyor;
1838
+ * DOM uzerinden yaziliyor. Kontrolun kendi `id`'si varsa korunur.
1839
+ */
1840
+ private wireControl;
1841
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpFieldComponent, never>;
1842
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpFieldComponent, "vp-field", never, { "label": { "alias": "label"; "required": true; }; "hint": { "alias": "hint"; "required": false; }; "error": { "alias": "error"; "required": false; }; "required": { "alias": "required"; "required": false; }; }, {}, never, ["*"], true, never>;
1843
+ }
1844
+
1845
+ type VpConfirmTone = 'neutral' | 'danger';
1846
+ /**
1847
+ * Onay dialogu — paket 05 · G7 + paket 07 · G5 (danger zone).
1848
+ *
1849
+ * Iki mod:
1850
+ * - **Normal**: onay butonu dogrudan etkin
1851
+ * - **Yikici**: `confirmPhrase` verilirse kullanici metni YAZMADAN onaylayamaz
1852
+ *
1853
+ * Yikici mod hesap silme, kuyruk temizleme, geri yukleme gibi geri alinamaz
1854
+ * islemler icindir. Buyuk/kucuk harf DUYARLI — kazara onay zorlasin.
1855
+ * Bas/son bosluk yok sayilir; kopyala-yapistir calismali.
1856
+ */
1857
+ declare class VpConfirmComponent implements AfterViewChecked, OnDestroy {
1858
+ open: boolean;
1859
+ title: string;
1860
+ message: string;
1861
+ /**
1862
+ * Verilirse **yikici mod**: kullanici bu metni birebir yazmadan onaylayamaz.
1863
+ * Hesap silme, kuyruk temizleme gibi geri alinamaz islemler icin.
1864
+ */
1865
+ confirmPhrase: string | null;
1866
+ tone: VpConfirmTone;
1867
+ confirmLabel: string;
1868
+ cancelLabel: string;
1869
+ phraseHintPrefix: string;
1870
+ phraseInputLabel: string;
1871
+ readonly confirmed: EventEmitter<void>;
1872
+ readonly cancelled: EventEmitter<void>;
1873
+ private readonly seq;
1874
+ protected readonly titleId: string;
1875
+ protected readonly messageId: string;
1876
+ private typedPhrase;
1877
+ private readonly hostRef;
1878
+ /**
1879
+ * Odak tuzagi — `vp-dialog` ve `vp-drawer` ile ORTAK (`createFocusTrap`).
1880
+ *
1881
+ * 🔴 Bu bilesende yoktu ve olmamasinin iki sonucu vardi. Birincisi:
1882
+ * `aria-modal="true"` diyip odagi tutmamak, ekran okuyucuya "kipsel pencere"
1883
+ * deyip klavyeye arkadaki sayfayi acik birakmak demek — ve bu, yikici
1884
+ * islemleri koruyan dialog. Ikincisi daha sessizdi: `Esc` dinleyicisi dialog
1885
+ * **elemaninin uzerindeydi**, yani olay ancak odak icerideyken geliyordu.
1886
+ * Odak hic iceri tasinmadigi icin `Esc` acilistan itibaren **olu tustu**.
1887
+ */
1888
+ private readonly trap;
1889
+ ngAfterViewChecked(): void;
1890
+ ngOnDestroy(): void;
1891
+ protected onKeydown(event: KeyboardEvent): void;
1892
+ private dialogEl;
1893
+ protected get canConfirm(): boolean;
1894
+ onPhraseInput(value: string): void;
1895
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpConfirmComponent, never>;
1896
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpConfirmComponent, "vp-confirm", never, { "open": { "alias": "open"; "required": false; }; "title": { "alias": "title"; "required": true; }; "message": { "alias": "message"; "required": true; }; "confirmPhrase": { "alias": "confirmPhrase"; "required": false; }; "tone": { "alias": "tone"; "required": false; }; "confirmLabel": { "alias": "confirmLabel"; "required": false; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; }; "phraseHintPrefix": { "alias": "phraseHintPrefix"; "required": false; }; "phraseInputLabel": { "alias": "phraseInputLabel"; "required": false; }; }, { "confirmed": "confirmed"; "cancelled": "cancelled"; }, never, never, true, never>;
1897
+ }
1898
+
1899
+ /**
1900
+ * Modal dialog — paket 05 · G7.
1901
+ *
1902
+ * Odak sozlesmesi (WCAG 2.2 · 2.4.3 · 2.4.11):
1903
+ * - Acilinca odak dialog ICINE tasinir
1904
+ * - Tab dialog icinde donguye girer (odak tuzagi)
1905
+ * - Kapaninca odak ACAN ogeye geri verilir
1906
+ *
1907
+ * Odak geri verilmezse klavye kullanicisi sayfanin basina firlar ve nerede
1908
+ * kaldigini kaybeder — en sik atlanan a11y hatasi.
1909
+ */
1910
+ declare class VpDialogComponent implements AfterViewChecked, OnDestroy {
1911
+ /**
1912
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
1913
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
1914
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
1915
+ *
1916
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
1917
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
1918
+ */
1919
+ protected readonly iconSprite: VpIconSpriteService;
1920
+ open: boolean;
1921
+ title: string;
1922
+ closeLabel: string;
1923
+ readonly closed: EventEmitter<void>;
1924
+ private readonly hostRef;
1925
+ protected readonly titleId: string;
1926
+ private readonly trap;
1927
+ ngAfterViewChecked(): void;
1928
+ ngOnDestroy(): void;
1929
+ protected onKeydown(event: KeyboardEvent): void;
1930
+ private dialogEl;
1931
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpDialogComponent, never>;
1932
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpDialogComponent, "vp-dialog", never, { "open": { "alias": "open"; "required": false; }; "title": { "alias": "title"; "required": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; }; }, { "closed": "closed"; }, never, ["*", "[footer]"], true, never>;
1933
+ }
1934
+
1935
+ /**
1936
+ * Bildirim yigini — paket 05 · G7.
1937
+ *
1938
+ * Duyurma kurallari (WCAG 2.2 · 4.1.3):
1939
+ * - Bolge `aria-live` ile HER ZAMAN DOM'da durur. Sonradan eklenirse
1940
+ * ekran okuyucu ilk mesaji **kacirir**.
1941
+ * - Bilgi/basari -> `role="status"` (polite; kullaniciyi kesmez)
1942
+ * - Uyari/hata -> `role="alert"` (assertive; hemen duyurulur)
1943
+ *
1944
+ * Otomatik kapanma:
1945
+ * - Basari/bilgi kapanabilir
1946
+ * - **Hata kapanmaz** — kullanici okumadan kaybolmamali
1947
+ * - **Aksiyonlu bildirim kapanmaz** — aksiyona ulasilamaz kalirdi
1948
+ */
1949
+ declare class VpToastComponent {
1950
+ /**
1951
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
1952
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
1953
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
1954
+ *
1955
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
1956
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
1957
+ */
1958
+ protected readonly iconSprite: VpIconSpriteService;
1959
+ toasts: VpToast[];
1960
+ dismissLabel: string;
1961
+ /** Otomatik kapanma suresi (ms) — bilgi/basari icin */
1962
+ defaultDismissMs: number;
1963
+ readonly dismissed: EventEmitter<string>;
1964
+ readonly actioned: EventEmitter<string>;
1965
+ /**
1966
+ * Bildirimin otomatik kapanma suresi. `0` = kapanmaz.
1967
+ *
1968
+ * Zamanlayiciyi bu bilesen KURMAZ — ust bilesen listeyi yonetir.
1969
+ * Burada yalnizca **politika** tanimlidir; boylece kural tek yerde durur
1970
+ * ve test edilebilir.
1971
+ */
1972
+ autoDismissMs(toast: VpToast): number;
1973
+ protected roleFor(tone: VpToastTone): 'alert' | 'status';
1974
+ protected iconRef(tone: VpToastTone): string;
1975
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpToastComponent, never>;
1976
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpToastComponent, "vp-toast", never, { "toasts": { "alias": "toasts"; "required": false; }; "dismissLabel": { "alias": "dismissLabel"; "required": false; }; "defaultDismissMs": { "alias": "defaultDismissMs"; "required": false; }; }, { "dismissed": "dismissed"; "actioned": "actioned"; }, never, never, true, never>;
1977
+ }
1978
+
1979
+ /**
1980
+ * Ciddiyet rozeti — paket 09 · G3.
1981
+ *
1982
+ * ## 🔴 Renk TEK BASINA anlam tasimaz (WCAG 1.4.1)
1983
+ *
1984
+ * Rozet her zaman **renk + ikon + metin** uclusuyle gelir. Yedi seviyenin
1985
+ * ikonu birbirinden farkli sekildedir; renk koru kullanici da ayirt eder.
1986
+ *
1987
+ * ## Iki giris yolu
1988
+ *
1989
+ * `level` dogrudan seviye
1990
+ * `value` + `scale` sayisal deger (0-100 veya 0-10)
1991
+ *
1992
+ * Ikinci yol, olculen hatanin cozumu: iki farkli olcek ayni seviyeye normalize
1993
+ * edilir, boylece "80/100" ile "8/10" ayni rozeti uretir.
1994
+ */
1995
+ declare class VpSeverityBadgeComponent {
1996
+ /**
1997
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
1998
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
1999
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
2000
+ *
2001
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
2002
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
2003
+ */
2004
+ protected readonly iconSprite: VpIconSpriteService;
2005
+ /** Dogrudan seviye. `value` ile birlikte verilirse bu kazanir. */
2006
+ level: VpSeverity | null;
2007
+ /** Sayisal deger — `scale` ile birlikte kullanilir. */
2008
+ value: number | null;
2009
+ scale: SeverityScale;
2010
+ /** Etiket metni. Verilmezse i18n anahtari gosterilir. */
2011
+ label: string | null;
2012
+ protected get resolved(): VpSeverity;
2013
+ protected get resolvedLabel(): string;
2014
+ protected get iconRef(): string;
2015
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpSeverityBadgeComponent, never>;
2016
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpSeverityBadgeComponent, "vp-severity-badge", never, { "level": { "alias": "level"; "required": false; }; "value": { "alias": "value"; "required": false; }; "scale": { "alias": "scale"; "required": false; }; "label": { "alias": "label"; "required": false; }; }, {}, never, never, true, never>;
2017
+ }
2018
+
2019
+ /**
2020
+ * Hash gosterimi — paket 09 · G6.
2021
+ *
2022
+ * Paket 00'in bulgusu: 64 karakterlik SHA256 degerleri `Scans.Name` alanina
2023
+ * yazilmis ve ekranda ham halde gorunuyor.
2024
+ *
2025
+ * Kurallar:
2026
+ * - Ilk 8 + son 8 karakter gosterilir, ortasi kisaltilir
2027
+ * - TAM deger `title` ve kopyalamada
2028
+ * - Satir kaydirma YOK — hash bolunmez
2029
+ * - Kopyalama TAM degeri verir, kisaltilmisi degil
2030
+ */
2031
+ declare class VpHashValueComponent {
2032
+ /**
2033
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
2034
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
2035
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
2036
+ *
2037
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
2038
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
2039
+ */
2040
+ protected readonly iconSprite: VpIconSpriteService;
2041
+ value: string;
2042
+ /** Bas ve sonda korunacak karakter sayisi */
2043
+ edge: number;
2044
+ copyLabel: string;
2045
+ readonly copied: EventEmitter<string>;
2046
+ protected get display(): string;
2047
+ protected copy(): void;
2048
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpHashValueComponent, never>;
2049
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpHashValueComponent, "vp-hash-value", never, { "value": { "alias": "value"; "required": true; }; "edge": { "alias": "edge"; "required": false; }; "copyLabel": { "alias": "copyLabel"; "required": false; }; }, { "copied": "copied"; }, never, never, true, never>;
2050
+ }
2051
+
2052
+ type VpIocType = 'url' | 'ip' | 'domain' | 'email' | 'hash';
2053
+ interface VpIoc {
2054
+ type: VpIocType;
2055
+ value: string;
2056
+ }
2057
+ /**
2058
+ * IOC listesi — paket 09 · G7.
2059
+ *
2060
+ * ## 🔴 IOC'ler LINK DEGILDIR
2061
+ *
2062
+ * Kullanici zararli bir adrese yanlislikla tiklayabilir. Degerler `<a href>`
2063
+ * icine **konmaz**; metin olarak gosterilir.
2064
+ *
2065
+ * ## Defanged gosterim (varsayilan ACIK)
2066
+ *
2067
+ * `http://` -> `hxxp://` · `1.2.3.4` -> `1.2.3[.]4`
2068
+ *
2069
+ * Sektor standardi. Kopyalanip yanlislikla adres cubuguna yapistirildiginda
2070
+ * bile calisan bir baglanti olusmaz.
2071
+ */
2072
+ declare class VpIocListComponent {
2073
+ /**
2074
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
2075
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
2076
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
2077
+ *
2078
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
2079
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
2080
+ */
2081
+ protected readonly iconSprite: VpIconSpriteService;
2082
+ items: VpIoc[];
2083
+ /** Defanged gosterim — varsayilan ACIK */
2084
+ defanged: boolean;
2085
+ warningLabel: string;
2086
+ protected format(item: VpIoc): string;
2087
+ protected iconRef(type: VpIocType): string;
2088
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpIocListComponent, never>;
2089
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpIocListComponent, "vp-ioc-list", never, { "items": { "alias": "items"; "required": false; }; "defanged": { "alias": "defanged"; "required": false; }; "warningLabel": { "alias": "warningLabel"; "required": false; }; }, {}, never, never, true, never>;
2090
+ }
2091
+
2092
+ /**
2093
+ * Sayisal ozet karti — paket 09 · G10.
2094
+ *
2095
+ * Kurallar:
2096
+ * - `0` **gosterilir** — "bos" ile "sifir" farkli bilgidir
2097
+ * - `null` bos durum gosterir, sifir degil
2098
+ * - Trend yonu YALNIZ renkle degil: isaret + `data-direction` de var
2099
+ * - Rakamlar tabular — deger guncellenirken metin oynamaz
2100
+ */
2101
+ declare class VpKpiCardComponent {
2102
+ /**
2103
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
2104
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
2105
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
2106
+ *
2107
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
2108
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
2109
+ */
2110
+ protected readonly iconSprite: VpIconSpriteService;
2111
+ label: string;
2112
+ /** `0` gecerli bir degerdir ve gosterilir. `null` bos durum demektir. */
2113
+ value: number | string | null;
2114
+ /** Onceki doneme gore degisim. `null` ise trend gosterilmez. */
2115
+ change: number | null;
2116
+ hint: string | null;
2117
+ emptyLabel: string;
2118
+ protected get direction(): 'up' | 'down' | 'flat';
2119
+ protected get changeText(): string;
2120
+ protected get trendIcon(): string;
2121
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpKpiCardComponent, never>;
2122
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpKpiCardComponent, "vp-kpi-card", never, { "label": { "alias": "label"; "required": true; }; "value": { "alias": "value"; "required": false; }; "change": { "alias": "change"; "required": false; }; "hint": { "alias": "hint"; "required": false; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; }; }, {}, never, never, true, never>;
2123
+ }
2124
+
2125
+ /**
2126
+ * Risk skoru gostergesi — paket 09 · G4.
2127
+ *
2128
+ * Kurallar:
2129
+ * - **Olcek referansi zorunlu.** "85" tek basina anlamsiz; "85 / 100" anlamli.
2130
+ * - **Seviye etiketi zorunlu.** Sayi tek basina yorumlanamaz.
2131
+ * - `null` -> "bilinmiyor", **`0` degil**. Olcemedigimiz sey temiz demek degil.
2132
+ * - `0` gosterilir: olculdu ve temiz cikti demektir.
2133
+ */
2134
+ declare class VpRiskScoreComponent {
2135
+ /**
2136
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
2137
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
2138
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
2139
+ *
2140
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
2141
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
2142
+ */
2143
+ protected readonly iconSprite: VpIconSpriteService;
2144
+ /** `null` = olculemedi. `0` = olculdu ve temiz. */
2145
+ value: number | null;
2146
+ scale: SeverityScale;
2147
+ /** Seviye etiketi. Verilmezse i18n anahtari gosterilir. */
2148
+ label: string | null;
2149
+ unknownLabel: string;
2150
+ ariaPrefix: string;
2151
+ protected get max(): number;
2152
+ protected get level(): VpSeverity;
2153
+ protected get levelLabel(): string;
2154
+ protected get iconRef(): string;
2155
+ /** Ekran okuyucu icin tam cumle — "85 / 100" parcali okunmasin. */
2156
+ protected get ariaLabel(): string;
2157
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpRiskScoreComponent, never>;
2158
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpRiskScoreComponent, "vp-risk-score", never, { "value": { "alias": "value"; "required": false; }; "scale": { "alias": "scale"; "required": false; }; "label": { "alias": "label"; "required": false; }; "unknownLabel": { "alias": "unknownLabel"; "required": false; }; "ariaPrefix": { "alias": "ariaPrefix"; "required": false; }; }, {}, never, never, true, never>;
2159
+ }
2160
+
2161
+ type VpEvidenceKind = 'engine' | 'static' | 'threat' | 'timing' | 'other';
2162
+ interface VpScoreEvidence {
2163
+ kind: VpEvidenceKind;
2164
+ label: string;
2165
+ /** `0` gecerli: "kontrol edildi, bulunamadi" bilgisidir. */
2166
+ count: number;
2167
+ detail?: string;
2168
+ }
2169
+ /**
2170
+ * Skor kirilimi — paket 09 · G12, **AŞAMA 1**.
2171
+ *
2172
+ * ## 🔴 Neden agirlik gostermiyor
2173
+ *
2174
+ * SDK model olcumu (2026-08-09):
2175
+ *
2176
+ * ```
2177
+ * ScanScoreType { name?, code? } // weight alani YOK
2178
+ * ScanScoreResult { data?: string } // opak, surumsuz
2179
+ * ScanScoreForTableDto { scoreResult? } // toplam var, bilesen bagi yok
2180
+ * ScanEngineRank { rank? } // "agirlik mi siralama mi" belirsiz
2181
+ * ```
2182
+ *
2183
+ * Toplam skoru bilesenlerine baglayan alan **yok**. Yuzde veya oran gostermek
2184
+ * uydurma olurdu.
2185
+ *
2186
+ * **Guvenlik urununde uydurma agirlik grafigi, hic gostermemekten kotudur.**
2187
+ * Kullanici sayilara guvenerek karar veriyor; sahte kirilim o guveni kirar.
2188
+ *
2189
+ * Aşama 1 yalnizca **"neyi gorduk"** der: kanit listesi ve sayilari.
2190
+ * Aşama 2 (backend sozlesmesi) geldiginde bu bilesen genisletilir.
2191
+ */
2192
+ declare class VpScoreBreakdownComponent {
2193
+ /**
2194
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
2195
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
2196
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
2197
+ *
2198
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
2199
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
2200
+ */
2201
+ protected readonly iconSprite: VpIconSpriteService;
2202
+ evidence: VpScoreEvidence[];
2203
+ title: string;
2204
+ emptyLabel: string;
2205
+ /**
2206
+ * Sinir aciklamasi. Varsayilan metin, agirlik gosterilmemesinin **nedenini**
2207
+ * soyluyor — kullanici eksik sanmasin.
2208
+ */
2209
+ note: string;
2210
+ protected iconRef(kind: VpEvidenceKind): string;
2211
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpScoreBreakdownComponent, never>;
2212
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpScoreBreakdownComponent, "vp-score-breakdown", never, { "evidence": { "alias": "evidence"; "required": false; }; "title": { "alias": "title"; "required": false; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; }; "note": { "alias": "note"; "required": false; }; }, {}, never, never, true, never>;
2213
+ }
2214
+
2215
+ /**
2216
+ * Ayar bolumu — paket 07.
2217
+ *
2218
+ * `VpMenuItem` ile ayni yetki/kosul ayrimini kullanir:
2219
+ * `hidden` -> yetkisiz, GORUNMEZ
2220
+ * `disabledReason` -> kosul saglanmadi, gorunur ama devre disi + sebep
2221
+ */
2222
+ interface VpSettingsSection {
2223
+ code: string;
2224
+ path: string;
2225
+ label: string;
2226
+ icon?: string;
2227
+ hidden?: boolean;
2228
+ disabledReason?: string;
2229
+ }
2230
+
2231
+ /**
2232
+ * Ayarlar kabugu — paket 07 · G1.
2233
+ *
2234
+ * Ikincil navigasyon + icerik alani. Her bolum kendi rotasi oldugu icin
2235
+ * **deep link paylasilabilir**; kabuk yalnizca hangisinin aktif oldugunu bilir.
2236
+ *
2237
+ * Paket 16'nin yetki/kosul ayrimi burada da gecerli:
2238
+ * `hidden` -> gorunmez · `disabledReason` -> devre disi + sebep
2239
+ *
2240
+ * Yerlesim: genis ekranda sol dikey, dar ekranda uste yigilir.
2241
+ */
2242
+ declare class VpSettingsShellComponent {
2243
+ sections: VpSettingsSection[];
2244
+ /** Aktif bolumun `code` degeri — rotadan gelir. */
2245
+ activeCode: string | null;
2246
+ navLabel: string;
2247
+ protected get visibleSections(): VpSettingsSection[];
2248
+ /** Ayarlar gezinme ikonu da PrimeIcons sozlugunden — bkz. `primeIconClass`. */
2249
+ protected iconClass(section: VpSettingsSection): string;
2250
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpSettingsShellComponent, never>;
2251
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpSettingsShellComponent, "vp-settings-shell", never, { "sections": { "alias": "sections"; "required": true; }; "activeCode": { "alias": "activeCode"; "required": false; }; "navLabel": { "alias": "navLabel"; "required": false; }; }, {}, never, ["*"], true, never>;
2252
+ }
2253
+
2254
+ /**
2255
+ * Yapiskan kaydet cubugu — paket 07 · G3.
2256
+ *
2257
+ * ## 🔴 Autosave YOK
2258
+ *
2259
+ * Guvenlik ayarlarinda istenmeyen kaydetme riski var: kullanici bir alani
2260
+ * yanlislikla degistirip sekmeyi kapatinca ayar kalici olmamali. Acik
2261
+ * `Kaydet` tercih edildi.
2262
+ *
2263
+ * Cubuk **yalnizca kirli durumda** gorunur. Her zaman duran bir cubuk
2264
+ * "kaydedilmemis bir sey var mi" sorusunu cevaplamaz.
2265
+ */
2266
+ declare class VpSaveBarComponent {
2267
+ /** Kaydedilmemis degisiklik var mi. `false` ise cubuk render EDILMEZ. */
2268
+ dirty: boolean;
2269
+ /** Kaydetme suruyor — iki dugme de pasiflesir, yarim durum olusmasin. */
2270
+ saving: boolean;
2271
+ message: string;
2272
+ saveLabel: string;
2273
+ savingLabel: string;
2274
+ discardLabel: string;
2275
+ readonly save: EventEmitter<void>;
2276
+ readonly discard: EventEmitter<void>;
2277
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpSaveBarComponent, never>;
2278
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpSaveBarComponent, "vp-save-bar", never, { "dirty": { "alias": "dirty"; "required": false; }; "saving": { "alias": "saving"; "required": false; }; "message": { "alias": "message"; "required": false; }; "saveLabel": { "alias": "saveLabel"; "required": false; }; "savingLabel": { "alias": "savingLabel"; "required": false; }; "discardLabel": { "alias": "discardLabel"; "required": false; }; }, { "save": "save"; "discard": "discard"; }, never, never, true, never>;
2279
+ }
2280
+
2281
+ /**
2282
+ * Danger zone bolumu — paket 07 · G5.
2283
+ *
2284
+ * Geri alinamaz islemler icin ayri, gorsel olarak ayrisan bolum.
2285
+ *
2286
+ * ⚠️ Bu bilesen **islemi yapmaz** — yalnizca `requested` olayini yayar.
2287
+ * Cift onay `vp-confirm`'un isi (`confirmPhrase` ile metin yazdirma).
2288
+ * Boylece "tikla ve sil" kazasi yapisal olarak imkansiz.
2289
+ */
2290
+ declare class VpDangerZoneComponent {
2291
+ /**
2292
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
2293
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
2294
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
2295
+ *
2296
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
2297
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
2298
+ */
2299
+ protected readonly iconSprite: VpIconSpriteService;
2300
+ title: string;
2301
+ description: string;
2302
+ actionLabel: string;
2303
+ /** Bekleme/geri alma bilgisi — "30 gün içinde geri alabilirsiniz" gibi. */
2304
+ waitNotice: string | null;
2305
+ disabled: boolean;
2306
+ /**
2307
+ * Onay ISTEGI. Islem burada YAPILMAZ — ust bilesen `vp-confirm` acar,
2308
+ * kullanici metni yazar, ancak ondan sonra islem calisir.
2309
+ */
2310
+ readonly requested: EventEmitter<void>;
2311
+ protected readonly titleId: string;
2312
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpDangerZoneComponent, never>;
2313
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpDangerZoneComponent, "vp-danger-zone", never, { "title": { "alias": "title"; "required": true; }; "description": { "alias": "description"; "required": true; }; "actionLabel": { "alias": "actionLabel"; "required": true; }; "waitNotice": { "alias": "waitNotice"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "requested": "requested"; }, never, never, true, never>;
2314
+ }
2315
+
2316
+ declare class VirusisUiModule {
2317
+ static ɵfac: i0.ɵɵFactoryDeclaration<VirusisUiModule, never>;
2318
+ static ɵmod: i0.ɵɵNgModuleDeclaration<VirusisUiModule, never, [typeof VpStateComponent, typeof VpShellComponent, typeof VpPageHeaderComponent, typeof VpBannerComponent, typeof VpTopbarComponent, typeof VpSidebarComponent, typeof VpBreadcrumbComponent, typeof VpDataTableComponent, typeof VpFieldComponent, typeof VpConfirmComponent, typeof VpDialogComponent, typeof VpToastComponent, typeof VpSeverityBadgeComponent, typeof VpHashValueComponent, typeof VpIocListComponent, typeof VpKpiCardComponent, typeof VpRiskScoreComponent, typeof VpScoreBreakdownComponent, typeof VpSettingsShellComponent, typeof VpSaveBarComponent, typeof VpDangerZoneComponent], [typeof VpStateComponent, typeof VpShellComponent, typeof VpPageHeaderComponent, typeof VpBannerComponent, typeof VpTopbarComponent, typeof VpSidebarComponent, typeof VpBreadcrumbComponent, typeof VpDataTableComponent, typeof VpFieldComponent, typeof VpConfirmComponent, typeof VpDialogComponent, typeof VpToastComponent, typeof VpSeverityBadgeComponent, typeof VpHashValueComponent, typeof VpIocListComponent, typeof VpKpiCardComponent, typeof VpRiskScoreComponent, typeof VpScoreBreakdownComponent, typeof VpSettingsShellComponent, typeof VpSaveBarComponent, typeof VpDangerZoneComponent]>;
2319
+ static ɵinj: i0.ɵɵInjectorDeclaration<VirusisUiModule>;
2320
+ }
2321
+
2322
+ type VpVerdictKind = 'clean' | 'suspicious' | 'malicious' | 'inconclusive';
2323
+ /**
2324
+ * Tarama sonucu ozeti — paket 09 · G5.
2325
+ *
2326
+ * ## 🔴 Tek cumle + ne yapmali
2327
+ *
2328
+ * Kullanici teknik rapordan once **tek soruya** cevap ariyor: "bu dosya tehlikeli
2329
+ * mi, ne yapmaliyim". Rakam yiginini basa koymak o cevabi geciktirir.
2330
+ *
2331
+ * ## 🔴 `inconclusive` ayri bir sonuc
2332
+ *
2333
+ * Motorlarin bir kismi cevap veremediyse sonuc "temiz" DEGILDIR. Guvenlik
2334
+ * urununde eksik bilgiyi olumlu sonuca yuvarlamak guven veren bir yalandir —
2335
+ * `vp-engine-result`'taki ayni kural, ozet seviyesinde.
2336
+ */
2337
+ declare class VpVerdictComponent {
2338
+ /**
2339
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
2340
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
2341
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
2342
+ *
2343
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
2344
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
2345
+ */
2346
+ protected readonly iconSprite: VpIconSpriteService;
2347
+ kind: VpVerdictKind;
2348
+ /** Tek cümle. Rakam değil, karar. */
2349
+ headline: string;
2350
+ /** Ne yapmalı. Boş bırakılabilir ama `malicious` için yazılmalı. */
2351
+ advice: string;
2352
+ /**
2353
+ * Kapsam notu — "12 motorun 9'u yanıt verdi" gibi.
2354
+ *
2355
+ * 🔴 `inconclusive` sonucun sebebini burada yazmak zorunlu değil ama
2356
+ * yazılmazsa kullanıcı sonucun neden kesin olmadığını bilemez.
2357
+ */
2358
+ coverageNote: string;
2359
+ actionLabel: string;
2360
+ readonly action: EventEmitter<void>;
2361
+ /**
2362
+ * 🔴 Ikon adlari BURADA uydurulmuyor; `severityMeta` uzerinden geliyor.
2363
+ *
2364
+ * Olculen hata (2026-08-28): bu dosya `#vp-icon-success`, `#vp-icon-warning`
2365
+ * ve `#vp-icon-info` diye **var olmayan** uc sembol istiyordu. Cozulemeyen
2366
+ * `<use>` hicbir sey cizmez ve hata da vermez — yani uc sonuc turunden ucu
2367
+ * ikonsuz kaliyordu ve kimse gormedi.
2368
+ *
2369
+ * ⚠️ Sonucu YALNIZ renk anlatiyor olurdu (kenarlik rengi); renk tek basina
2370
+ * anlam tasiyamaz (WCAG 1.4.1). `vp-severity-badge` ayni gerekceyle ikon
2371
+ * kullaniyor — orada dogru, burada ad uydurulmustu.
2372
+ */
2373
+ protected get iconRef(): string;
2374
+ /** Sonuc turunun ciddiyet olcegindeki karsiligi — ikon ve anlam tek yerden. */
2375
+ private get severity();
2376
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpVerdictComponent, never>;
2377
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpVerdictComponent, "vp-verdict", never, { "kind": { "alias": "kind"; "required": true; }; "headline": { "alias": "headline"; "required": true; }; "advice": { "alias": "advice"; "required": false; }; "coverageNote": { "alias": "coverageNote"; "required": false; }; "actionLabel": { "alias": "actionLabel"; "required": false; }; }, { "action": "action"; }, never, never, true, never>;
2378
+ }
2379
+
2380
+ /**
2381
+ * Tek motorun sonucu — paket 09 · G9.
2382
+ *
2383
+ * ## 🔴 "Bulgu yok" ile "motor calismadi" AYNI SEY DEGIL
2384
+ *
2385
+ * Olculen hata sinifi: basarisiz motor, temiz sonuc gibi gorunuyor. Kullanici
2386
+ * 12 motorun 12'sinin "temiz" dedigini saniyor; oysa 3'u hic cevap vermemis.
2387
+ * Guvenlik urununde bu, guven veren bir yalandir.
2388
+ *
2389
+ * Bu yuzden `error` ayri bir durum: farkli ikon, farkli metin, rozet YOK.
2390
+ * Rozet gosterilseydi (or. gri "bilinmiyor") hala bir "sonuc" gibi okunurdu.
2391
+ */
2392
+ declare class VpEngineResultComponent {
2393
+ /**
2394
+ * 🔴 Enjeksiyon SUS DEGIL: `VpIconSpriteService` kurucusunda SVG sembol
2395
+ * deposunu belgeye gomer. Gomulmezse bu bilesenin `<use>` etiketleri
2396
+ * **hicbir sey cizmez ve hata vermez** — olculen sessiz kayip.
2397
+ *
2398
+ * ⚠️ Alan kullanilmiyor gibi gorunur; isi enjekte edilmis olmaktir.
2399
+ * `test/icon-sprite-wiring.spec.ts` bu esleSMeyi zorunlu tutuyor.
2400
+ */
2401
+ protected readonly iconSprite: VpIconSpriteService;
2402
+ engine: string;
2403
+ /** Motor cevap veremedi. `detection`/`severity` DIKKATE ALINMAZ. */
2404
+ error: boolean;
2405
+ errorDetail: string;
2406
+ /** Bulgu adi. Bos + `error` degilse motor temiz demistir. */
2407
+ detection: string;
2408
+ severity: VpSeverity;
2409
+ cleanLabel: string;
2410
+ errorLabel: string;
2411
+ protected get state(): 'error' | 'detected' | 'clean';
2412
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpEngineResultComponent, never>;
2413
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpEngineResultComponent, "vp-engine-result", never, { "engine": { "alias": "engine"; "required": true; }; "error": { "alias": "error"; "required": false; }; "errorDetail": { "alias": "errorDetail"; "required": false; }; "detection": { "alias": "detection"; "required": false; }; "severity": { "alias": "severity"; "required": false; }; "cleanLabel": { "alias": "cleanLabel"; "required": false; }; "errorLabel": { "alias": "errorLabel"; "required": false; }; }, {}, never, never, true, never>;
2414
+ }
2415
+
2416
+ /**
2417
+ * Tek bulgu satiri — paket 09 · G8.
2418
+ *
2419
+ * ## 🔴 `severity` ve `confidence` AYRI eksenler
2420
+ *
2421
+ * Sik yapilan hata ikisini tek bir "skor"da birlestirmek. Anlamlari farkli:
2422
+ *
2423
+ * severity = dogruysa NE KADAR KOTU
2424
+ * confidence = DOGRU OLMA ihtimali
2425
+ *
2426
+ * "Kritik ama %20 guvenilir" ile "dusuk ama %99 guvenilir" tamamen farkli
2427
+ * kararlar gerektirir; tek sayiya indirmek bu farki yok eder ve kullanici
2428
+ * yanlis onceliklendirir.
2429
+ *
2430
+ * Bu yuzden severity ROZET (renk+ikon+metin), confidence ise AYRI ve
2431
+ * yuzde olarak yazili — gorsel olarak birbirine karismazlar.
2432
+ */
2433
+ declare class VpDetectionRowComponent {
2434
+ name: string;
2435
+ /** Bulguyu bildiren motor/kaynak. */
2436
+ source: string;
2437
+ severity: VpSeverity;
2438
+ /**
2439
+ * 0–100. `null` = kaynak guven bildirmedi.
2440
+ *
2441
+ * 🔴 `null` ile `0` ayni sey DEGIL: `0` "kesinlikle yanlis pozitif", `null`
2442
+ * "bilgi yok" demektir. `0` varsayilan yapilsaydi her bilgisiz bulgu
2443
+ * "guvenilmez" gorunurdu.
2444
+ */
2445
+ confidence: number | null;
2446
+ description: string;
2447
+ confidenceLabel: string;
2448
+ confidenceUnknownLabel: string;
2449
+ protected get hasConfidence(): boolean;
2450
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpDetectionRowComponent, never>;
2451
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpDetectionRowComponent, "vp-detection-row", never, { "name": { "alias": "name"; "required": true; }; "source": { "alias": "source"; "required": false; }; "severity": { "alias": "severity"; "required": false; }; "confidence": { "alias": "confidence"; "required": false; }; "description": { "alias": "description"; "required": false; }; "confidenceLabel": { "alias": "confidenceLabel"; "required": false; }; "confidenceUnknownLabel": { "alias": "confidenceUnknownLabel"; "required": false; }; }, {}, never, never, true, never>;
2452
+ }
2453
+
2454
+ type VpStageState = 'pending' | 'running' | 'done' | 'failed' | 'skipped';
2455
+ interface VpScanStage {
2456
+ code: string;
2457
+ label: string;
2458
+ state: VpStageState;
2459
+ /** Tamamlanmis asama icin sure (ms). Bilinmiyorsa `null`. */
2460
+ durationMs?: number | null;
2461
+ /** Basarisiz asamanin sebebi. `failed` icin YAZILMALI. */
2462
+ detail?: string;
2463
+ }
2464
+ /**
2465
+ * Tarama asamalari — paket 09 · G11.
2466
+ *
2467
+ * ## 🔴 Basarisiz asama, calisan asama gibi gorunmez
2468
+ *
2469
+ * Bir asama `failed` oldugunda ilerleme durur ama bekleyen asamalar hala listede.
2470
+ * `failed`'i `running` gibi (donen ikon, "devam ediyor" hissi) gostermek
2471
+ * kullaniciyi bekletir — tarama bitmistir, bir daha ilerlemeyecektir.
2472
+ *
2473
+ * Ayri ikon + ayri metin + `detail` alani zorunlu ayrimi saglar.
2474
+ *
2475
+ * ## 🔴 Canli akis GERI GITMEZ
2476
+ *
2477
+ * SignalR olaylari sirasiz gelebilir (`live-stream-signalr-only` kurali geregi
2478
+ * polling YOK, tek kaynak akis). Tamamlanmis bir asamayi `running`'e dusuren bir
2479
+ * olay kullaniciya "ilerleme geri gitti" gosterir ve guveni kirar.
2480
+ *
2481
+ * `mergeStageUpdate` durum siralamasini uygular: bir asama yalnizca ILERI gider.
2482
+ */
2483
+ declare class VpScanTimelineComponent {
2484
+ stages: VpScanStage[];
2485
+ label: string;
2486
+ stateLabels: Record<VpStageState, string>;
2487
+ protected stateLabel(state: VpStageState): string;
2488
+ /**
2489
+ * Renk tek basina anlam tasimaz (WCAG 1.4.1): her durumun ayri isareti var,
2490
+ * ayrica gorsel olmayan kullanicilar icin gizli metin durumu okuyor.
2491
+ */
2492
+ protected glyph(state: VpStageState): string;
2493
+ protected formatDuration(ms: number): string;
2494
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpScanTimelineComponent, never>;
2495
+ static ɵcmp: i0.ɵɵComponentDeclaration<VpScanTimelineComponent, "vp-scan-timeline", never, { "stages": { "alias": "stages"; "required": false; }; "label": { "alias": "label"; "required": false; }; "stateLabels": { "alias": "stateLabels"; "required": false; }; }, {}, never, never, true, never>;
2496
+ }
2497
+ /**
2498
+ * Canli akistan gelen bir asama guncellemesini uygular.
2499
+ *
2500
+ * 🔴 **Asama yalnizca ILERI gider.** SignalR olaylari sirasiz gelebilir; tamamlanmis
2501
+ * bir asamayi `running`'e dusuren bir olay kullaniciya "ilerleme geri gitti"
2502
+ * gosterir ve guveni kirar. Geri giden guncelleme YOK SAYILIR.
2503
+ *
2504
+ * `failed` en ileri durumdur: bir kez basarisiz olan asama sonradan gelen bir
2505
+ * `done` olayiyla "duzelmis" gibi gosterilmez — hata gizlenmez.
2506
+ *
2507
+ * Bilinmeyen asama koduna gelen guncelleme listeye EKLENMEZ: asama listesi
2508
+ * sunucunun bildirdigi plandir, akis onu genisletemez.
2509
+ */
2510
+ declare function mergeStageUpdate(stages: ReadonlyArray<VpScanStage>, update: Pick<VpScanStage, 'code' | 'state'> & Partial<VpScanStage>): VpScanStage[];
2511
+
2512
+ /**
2513
+ * Kaydedilmemis degisiklik korumasi — paket 07 · G4.
2514
+ *
2515
+ * `vp-save-bar` (G3) kirli durumu **gosteriyor** ama korumuyor: kullanici
2516
+ * kaydetmeden baska bir bolume geciyorsa cubuk sessizce kayboluyor ve
2517
+ * degisiklikler gidiyor. Autosave bilerek YOK (guvenlik ayarlarinda istenmeyen
2518
+ * kayit riski, bkz. `VpSaveBarComponent`) — dolayisiyla tek koruma bu.
2519
+ */
2520
+ /** Rota bileseni bunu uygular; kirli olup olmadigini yalniz o bilir. */
2521
+ interface VpUnsavedChanges {
2522
+ hasUnsavedChanges(): boolean;
2523
+ }
2524
+ type VpConfirmResult = boolean | Promise<boolean> | Observable<boolean>;
2525
+ /**
2526
+ * Onay diyalogunu **uygulama** saglar.
2527
+ *
2528
+ * 🔴 Neden token: bu paket tasarim sistemidir, uygulamanin diyalog altyapisini
2529
+ * (PrimeNG `ConfirmationService`, kendi modal'i, …) bilmez ve bilmemeli. Guard
2530
+ * icine bir diyalog gomulseydi her tuketici onu ezmek zorunda kalirdi.
2531
+ *
2532
+ * Varsayilan `window.confirm`: cirkin ama CALISIR. Varsayilan olmasaydi koruma
2533
+ * "birileri baglayana kadar" kapali kalirdi — yani hic olmayan koruma.
2534
+ */
2535
+ declare const VP_UNSAVED_CHANGES_CONFIRM: InjectionToken<() => VpConfirmResult>;
2536
+ /**
2537
+ * Rota degisiminde kirli formu korur.
2538
+ *
2539
+ * ```ts
2540
+ * { path: 'security', component: SecuritySettings, canDeactivate: [vpUnsavedChangesGuard] }
2541
+ * ```
2542
+ *
2543
+ * Bilesen <see cref="VpUnsavedChanges"/> uygulamiyorsa guard **gecirir** — koruma
2544
+ * istemeyen rotalar guard'i zaten eklemez; uygulamayan bir bileseni bloklamak
2545
+ * sessiz kilitlenme olurdu.
2546
+ */
2547
+ declare const vpUnsavedChangesGuard: CanDeactivateFn<unknown>;
2548
+ /**
2549
+ * Sekme kapatma / yenileme korumasi — rota guard'inin YAPAMADIGI kisim.
2550
+ *
2551
+ * ⚠️ Ayri bir mekanizma ve ayri kisitlari var:
2552
+ * - Tarayici **kendi** metnini gosterir; ozel mesaj yok sayilir (spec geregi).
2553
+ * - Kullanicinin sayfayla etkilesmis olmasi gerekir, yoksa bazi tarayicilar
2554
+ * diyalogu hic gostermez.
2555
+ *
2556
+ * Bu yuzden guard'in yerine gecmez, tamamlar. Opt-in: cagiran acikca baglar.
2557
+ *
2558
+ * @returns dinleyiciyi kaldiran fonksiyon
2559
+ */
2560
+ declare function registerUnsavedChangesPrompt(isDirtyFn: () => boolean): () => void;
2561
+
2562
+ /**
2563
+ * `UserViewsServiceRxClass` → `userViewsService`
2564
+ *
2565
+ * SDK'nin `createAllRxClientsCamel` fonksiyonuyla ayni kural: `RxClass` eki
2566
+ * atilir, ilk harf kucultulur. Eslesmeyen ad `null` doner.
2567
+ */
2568
+ declare function rxServiceKeyOf(className: string): string | null;
2569
+ interface VpRxBinding {
2570
+ /** SDK'daki sinif — DI token'i. */
2571
+ token: unknown;
2572
+ /** `getServicesRx()` ciktisindaki ornek. */
2573
+ value: unknown;
2574
+ className: string;
2575
+ serviceKey: string;
2576
+ }
2577
+ /**
2578
+ * SDK ad alanindaki her `*RxClass` icin token↔ornek ciftini kurar.
2579
+ */
2580
+ declare function collectRxBindings(sdk: Record<string, unknown>, rxServices: Record<string, unknown>): VpRxBinding[];
2581
+ /**
2582
+ * Karsiligi bulunamayan `*RxClass` adlari.
2583
+ *
2584
+ * 🔴 Sessizce atlamak, cozmek icin var oldugumuz hatayi geri getirir: kaydi
2585
+ * yapilmamis bir istemci yine `NG0201` uretir, ustelik bu kez "otomatik kayit
2586
+ * var" sanildigi icin teshisi daha zordur. Bu liste bir test kapisidir.
2587
+ */
2588
+ declare function unmatchedRxClasses(sdk: Record<string, unknown>, rxServices: Record<string, unknown>): string[];
2589
+ interface VpApiClientProviderOptions {
2590
+ /** `import * as sdk from '@virusis/api-client'` */
2591
+ sdk: Record<string, unknown>;
2592
+ /** `getServicesRx()` sonucu — tum istemciler AYNI config'i paylasir. */
2593
+ rxServices: Record<string, unknown>;
2594
+ /**
2595
+ * Eslesmeyen sinif bulununca ne yapilsin.
2596
+ *
2597
+ * Varsayilan `warn`: uygulama acilir ama konsolda gorunur. `throw` CI/test
2598
+ * icin; sessiz gecis SECENEK DEGIL (bkz. `unmatchedRxClasses`).
2599
+ */
2600
+ onUnmatched?: 'warn' | 'throw';
2601
+ }
2602
+ declare function provideVirusisApiClient(options: VpApiClientProviderOptions): Provider[];
2603
+
2604
+ /**
2605
+ * Sekmeler arasi durum senkronu — paket 05 · G9.
2606
+ *
2607
+ * Ayni kullanici iki sekme aciyor. Birinde cikis yapiyor, temayi degistiriyor veya
2608
+ * bakim moduna dusuyor — digeri hicbir sey bilmiyor. Sonuc: bir sekmede oturum
2609
+ * kapali, digerinde acik gorunuyor; kullanici hangisinin dogru oldugunu bilmiyor.
2610
+ *
2611
+ * ## 🔴 Iki tasiyici, tek sozlesme
2612
+ *
2613
+ * `BroadcastChannel` her yerde yok (SSR'da hic, eski Safari'de kismi). Tek basina
2614
+ * kullanilsaydi ozellik sessizce calismayan bir sey olurdu. `storage` olayi
2615
+ * fallback: `localStorage`'a yazmak DIGER sekmelerde `storage` olayini tetikler
2616
+ * (yazan sekmede tetiklenmez — echo sorunu dogal olarak yok).
2617
+ *
2618
+ * ## 🔴 Kendi mesajini duyma
2619
+ *
2620
+ * `BroadcastChannel` yazan sekmeye geri gondermez, ama ayni sayfada iki abone
2621
+ * varsa birbirlerini duyar. Her mesaj bir gonderici kimligi tasir; kendi
2622
+ * kimliginden gelen mesaj YOK SAYILIR — aksi halde "cikis yap" mesaji sonsuz
2623
+ * donguye girebilir.
2624
+ */
2625
+ interface VpTabMessage<T = unknown> {
2626
+ /** Gonderen sekme/abone kimligi — echo filtresi. */
2627
+ senderId: string;
2628
+ payload: T;
2629
+ /** Gonderim ani (ms). Eski `storage` kaydini yeniden okumayi ayirt eder. */
2630
+ sentAt: number;
2631
+ }
2632
+ interface VpTabSync<T> {
2633
+ post(payload: T): void;
2634
+ close(): void;
2635
+ readonly senderId: string;
2636
+ }
2637
+ interface VpTabSyncOptions {
2638
+ /** Test ve SSR icin enjekte edilebilir. */
2639
+ now?: () => number;
2640
+ newId?: () => string;
2641
+ }
2642
+ /**
2643
+ * Kanal acar. Tarayici yoksa (SSR) **sessizce no-op** doner — cagiran platform
2644
+ * kontrolu yazmak zorunda kalmasin.
2645
+ */
2646
+ declare function createTabSync<T>(channelName: string, onMessage: (payload: T) => void, options?: VpTabSyncOptions): VpTabSync<T>;
2647
+
2648
+ /**
2649
+ * Ortak i18n ad alani + dil esitligi — paket 05 · G8.
2650
+ *
2651
+ * Bilesenler Turkce varsayilan metinlerle geliyor (`Kaydet`, `Vazgec`, …) ve her
2652
+ * biri `@Input` ile ezilebiliyor. Bu, tasarim sistemini bir ceviri kutuphanesine
2653
+ * bagimli yapmamak icin bilincli bir karar. Ama tuketici uygulama cevirileri
2654
+ * bagladiginda **anahtarlarin iki dilde de var olmasi** gerekiyor.
2655
+ *
2656
+ * ## 🔴 Eksik anahtar kullaniciya HAM ANAHTAR gosterir
2657
+ *
2658
+ * `@ngx-translate` bulunamayan anahtari oldugu gibi basar: kullanici ekranda
2659
+ * `menu.settings` gorur. Ingilizce'ye dusmekten de kotudur — hata gibi degil,
2660
+ * BOZUKLUK gibi gorunur.
2661
+ *
2662
+ * `findMissingKeys` bu farki CI'da gorunur kilar.
2663
+ */
2664
+ declare const VP_I18N_NAMESPACE = "vp";
2665
+ /** `vp.table.empty` — ad alani her zaman onde, cakisma olmasin. */
2666
+ declare function vpKey(...parts: string[]): string;
2667
+ type VpTranslations = {
2668
+ [key: string]: string | VpTranslations;
2669
+ };
2670
+ /**
2671
+ * Ic ice sozlugu duz anahtar listesine cevirir.
2672
+ *
2673
+ * `{ a: { b: 'x' } }` → `['a.b']`
2674
+ */
2675
+ declare function flattenKeys(source: VpTranslations, prefix?: string): string[];
2676
+ interface VpKeyParity {
2677
+ /** Referansta olup hedefte OLMAYAN — kullanici ham anahtar gorur. */
2678
+ missing: string[];
2679
+ /** Hedefte olup referansta olmayan — olu ceviri, temizlenmeli. */
2680
+ extra: string[];
2681
+ ok: boolean;
2682
+ }
2683
+ /**
2684
+ * Iki dil dosyasini karsilastirir.
2685
+ *
2686
+ * ⚠️ `extra` de raporlanir ama **hata degildir**: olu ceviri kullaniciyi
2687
+ * etkilemez, yalnizca bakim yuku. `ok` yalnizca `missing` bos oldugunda `true` —
2688
+ * kapiyi kullaniciyi etkileyen fark belirler.
2689
+ */
2690
+ declare function findMissingKeys(reference: VpTranslations, target: VpTranslations): VpKeyParity;
2691
+ /**
2692
+ * Bos degerli anahtarlar.
2693
+ *
2694
+ * 🔴 Bos string anahtar VARDIR ama ceviri YOKTUR — `findMissingKeys` bunu
2695
+ * yakalayamaz cunku anahtar teknik olarak mevcut. Kullanici ekranda **bos alan**
2696
+ * gorur; ham anahtardan bile teshisi zordur.
2697
+ */
2698
+ declare function findEmptyValues(source: VpTranslations, prefix?: string): string[];
2699
+ declare function formatParityReport(locale: string, parity: VpKeyParity): string;
2700
+
2701
+ /**
2702
+ * Statik menu kaynagi — paket 16 · G9 (LocalAdmin).
2703
+ *
2704
+ * ## 🔴 Neden DB'siz bir kaynak gerekiyor
2705
+ *
2706
+ * On-prem kurulumda merkezi DB **olmayabilir**. LocalAdmin menusunu
2707
+ * `Menus` tablosundan cekmek, urunu calistirmak icin merkeze baglanmayi zorunlu
2708
+ * kilardi — on-prem'in varlik sebebine aykiri.
2709
+ *
2710
+ * ## Sozlesme AYNI, kaynak farkli
2711
+ *
2712
+ * Statik menu de `VpMenuItem` uretir; `vp-sidebar` ikisini ayirt etmez. Yetki ve
2713
+ * kosul cozumu de ayni (`resolveMenuConditions`). Tek fark maddelerin nereden
2714
+ * geldigi.
2715
+ */
2716
+ interface VpStaticMenuIssue {
2717
+ code: string;
2718
+ problem: 'duplicate-code' | 'missing-path' | 'missing-code' | 'unknown-parent';
2719
+ }
2720
+ /**
2721
+ * Statik tanimi dogrular.
2722
+ *
2723
+ * 🔴 Neden dogrulama var: DB kaynagi bir sema tarafindan korunuyor (benzersiz
2724
+ * `Code`, zorunlu alanlar). Statik tanim elle yazilan bir dizi — hicbir sey
2725
+ * tekrarlanan kodu veya bos yolu engellemiyor. Hata calisma zamaninda "menu
2726
+ * maddesine tiklayinca hicbir sey olmuyor" seklinde gorunur; teshisi zordur.
2727
+ *
2728
+ * Dogrulama bunu **test zamaninda** yakalar.
2729
+ */
2730
+ declare function validateStaticMenu(items: ReadonlyArray<VpConditionalMenuItem>): VpStaticMenuIssue[];
2731
+ /**
2732
+ * Statik menuyu tanimlar ve **gecersizse patlar**.
2733
+ *
2734
+ * Sessizce bozuk menu render etmektense acilista basarisiz olmak iyidir: on-prem
2735
+ * kurulumda hatayi goren tek kisi operatordur ve hatayi acikca gormeli.
2736
+ */
2737
+ declare function defineStaticMenu(items: ReadonlyArray<VpConditionalMenuItem>): VpConditionalMenuItem[];
2738
+ /** Kosulsuz, dogrudan kullanilabilir hale getirir (kosul cozumu istemeyen kaynaklar icin). */
2739
+ declare function toMenuItems(items: ReadonlyArray<VpConditionalMenuItem>): VpMenuItem[];
2740
+
2741
+ /**
2742
+ * Paket 10 · G2 — konsol interceptor seti (`auth/core`).
2743
+ *
2744
+ * ## Neden ayrı
2745
+ *
2746
+ * Prime'ın auth yığını **anonim trial için** kuruldu: `trial-auth.service.ts` 1.891
2747
+ * satır, 18 guard, 17 interceptor, iki ayrı `isAuthenticated()`. Customer Console'a
2748
+ * olduğu gibi kopyalanırsa giriş yapmış kullanıcıya anon makinesi de gelir —
2749
+ * `SharedVisitorAuth`, `Captcha`, `TrialAuth`, device-hash, HMAC assertion cookie.
2750
+ * Hiçbiri gerekmiyor, hepsi bakım yükü ve saldırı yüzeyi.
2751
+ *
2752
+ * ## Neden port
2753
+ *
2754
+ * Interceptor'lar Prime'ın servis sınıflarına bağlı; sınıfı taşımak servisi de
2755
+ * taşımak, o da başka servisi taşımak demek. Zincir arayüzle kesiliyor: tasarım
2756
+ * sistemi **ne yapılacağını** bilir, **nereden geleceğini** uygulama söyler.
2757
+ * Bu sayede paket SSR'da ve testte sahte portla çalışır.
2758
+ *
2759
+ * ## Neden `anon` burada YOK
2760
+ *
2761
+ * Bugün tek tüketicisi `virusis.com` ve Customer Console'un onu **almaması**
2762
+ * gerekiyor. Sınır testle korunuyor (`vp-auth-chain.spec.ts` — anon işareti
2763
+ * taşıyan interceptor zincire giremez), kod taşımayla değil.
2764
+ *
2765
+ * ⚠️ Bu **kalıcı bir sınır değil**. MFE analizi (`07-trial-layout` §11) trial'ın
2766
+ * tamamını `app.virusis.com`'a taşıyor ve `virusis.com/trial/**` için
2767
+ * `301 → app.virusis.com` diyor; konsol rotaları orada `anon veya customer`
2768
+ * olarak işaretli. Yani anon seti sonunda Customer Console'da da tüketilecek,
2769
+ * ayrı bir sağlayıcı kümesi olarak (`provideVpAuthAnon()`).
2770
+ *
2771
+ * Ayrımın kendisi her iki durumda da doğru: değişen şey anon setinin **nerede**
2772
+ * tüketildiği, ayrı durup durmadığı değil.
2773
+ *
2774
+ * Envanter ve gerekçeler:
2775
+ * `Docs/implementation/10-customer-console-iskelet/auth-ayrisma-envanteri.md`
2776
+ */
2777
+ /**
2778
+ * Zincir sırası **davranışsaldır**, alfabetik veya keyfî değil.
2779
+ *
2780
+ * 🔴 `maintenance` `http-error`'dan ÖNCE (dış). Sonra olsaydı `http-error`'ın
2781
+ * retry'ları tükenmeden bakım sinyali okunur ve tek seferlik bir ağ hatası kalıcı
2782
+ * bakım yönlendirmesine dönerdi. Prime'da bu kural yalnızca yorumla korunuyordu;
2783
+ * yorum bir davranışı koruyamaz.
2784
+ *
2785
+ * `scan` ve `app` yuvaları burada **tanımlı ama boş**: uygulama kendi
2786
+ * interceptor'ını o noktaya kaydeder. Yuvayı listeden çıkarmak, sırayı bilen tek
2787
+ * kaynağı ikiye bölerdi.
2788
+ */
2789
+ declare const VP_AUTH_CHAIN_ORDER: readonly ["csrf", "app-key", "auth-token", "session-token", "http-ids", "maintenance", "load-progress", "http-error", "with-credentials", "network-snapshot", "obfuscate"];
2790
+ type VpAuthChainSlot = (typeof VP_AUTH_CHAIN_ORDER)[number];
2791
+ /**
2792
+ * Yuvanın zincirdeki konumu.
2793
+ *
2794
+ * Bilinmeyen yuvada **patlar**. `-1` döndürseydi `slotOf('maintenanace') <
2795
+ * slotOf('http-error')` yazım hatalı bir karşılaştırma sessizce geçerdi ve sıra
2796
+ * testi hiçbir şeyi korumaz olurdu.
2797
+ */
2798
+ declare function vpAuthChainSlotOf(slot: string): number;
2799
+ /** CSRF çerezini okuyan uygulama servisi. */
2800
+ interface VpCsrfPort {
2801
+ readToken(): string | null;
2802
+ }
2803
+ /** Erişim jetonunu veren uygulama servisi (KC OIDC, trial auth, ne olursa). */
2804
+ interface VpAuthTokenPort {
2805
+ readAccessToken(): string | null;
2806
+ }
2807
+ /** Korelasyon kimliği üreten / yanıt kimliğini toplayan uygulama servisi. */
2808
+ interface VpRequestContextPort {
2809
+ readonly correlationId: string;
2810
+ captureResponseId(requestId: string): void;
2811
+ }
2812
+ interface VpMaintenanceSignal {
2813
+ statusCode: number;
2814
+ retryAfterSeconds: number | null;
2815
+ }
2816
+ /** Bakım sinyalini alan uygulama servisi — banner mı yönlendirme mi, uygulama karar verir. */
2817
+ interface VpMaintenancePort {
2818
+ report(signal: VpMaintenanceSignal): void;
2819
+ }
2820
+ declare const VP_APP_KEY: InjectionToken<string>;
2821
+ declare const VP_API_BASE_URLS: InjectionToken<readonly string[]>;
2822
+ declare const VP_CSRF_PORT: InjectionToken<VpCsrfPort>;
2823
+ declare const VP_AUTH_TOKEN_PORT: InjectionToken<VpAuthTokenPort>;
2824
+ declare const VP_REQUEST_CONTEXT_PORT: InjectionToken<VpRequestContextPort>;
2825
+ declare const VP_MAINTENANCE_PORT: InjectionToken<VpMaintenancePort>;
2826
+ /**
2827
+ * `X-App-Key` — hangi ürünün konuştuğu.
2828
+ *
2829
+ * 🔴 Değer **enjeksiyondan** gelir, literal olarak yazılmaz. Aynı hata üç kez
2830
+ * yaşandı: AdminPanel (2026-06-07) ve PrivateAPI-UI (2026-08-14) Prime'ın
2831
+ * `0101000`'ini gönderdi — ikincisinde `APP_KEY_TRIAL_UI` sabit adı bile
2832
+ * kopyalanmıştı — ve Prime'ın `app-key.interceptor.ts:19`'unda literal hâlâ
2833
+ * duruyor. Backend karşılığı `Entities/Concrete/AppKeyRegistry`.
2834
+ */
2835
+ declare class VpAppKeyInterceptor implements HttpInterceptor {
2836
+ private readonly appKey;
2837
+ constructor(appKey: string);
2838
+ intercept(req: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;
2839
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpAppKeyInterceptor, never>;
2840
+ static ɵprov: i0.ɵɵInjectableDeclaration<VpAppKeyInterceptor>;
2841
+ }
2842
+ declare class VpCsrfInterceptor implements HttpInterceptor {
2843
+ private readonly csrf;
2844
+ constructor(csrf: VpCsrfPort);
2845
+ intercept(req: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;
2846
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpCsrfInterceptor, never>;
2847
+ static ɵprov: i0.ɵɵInjectableDeclaration<VpCsrfInterceptor>;
2848
+ }
2849
+ declare class VpAuthTokenInterceptor implements HttpInterceptor {
2850
+ private readonly auth;
2851
+ constructor(auth: VpAuthTokenPort);
2852
+ intercept(req: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;
2853
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpAuthTokenInterceptor, never>;
2854
+ static ɵprov: i0.ɵɵInjectableDeclaration<VpAuthTokenInterceptor>;
2855
+ }
2856
+ declare class VpHttpIdsInterceptor implements HttpInterceptor {
2857
+ private readonly context;
2858
+ constructor(context: VpRequestContextPort);
2859
+ intercept(req: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;
2860
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpHttpIdsInterceptor, never>;
2861
+ static ɵprov: i0.ɵɵInjectableDeclaration<VpHttpIdsInterceptor>;
2862
+ }
2863
+ /**
2864
+ * Bakım sinyali.
2865
+ *
2866
+ * `instanceof HttpErrorResponse` **kontrol edilmiyor**: zincirin üstündeki
2867
+ * interceptor'lar hatayı sarmalayabilir ve o zaman bakım sessizce kaybolurdu.
2868
+ * Sözleşme sayısal `status` alanı.
2869
+ */
2870
+ declare class VpMaintenanceInterceptor implements HttpInterceptor {
2871
+ private readonly maintenance;
2872
+ constructor(maintenance: VpMaintenancePort);
2873
+ intercept(req: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;
2874
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpMaintenanceInterceptor, never>;
2875
+ static ɵprov: i0.ɵɵInjectableDeclaration<VpMaintenanceInterceptor>;
2876
+ }
2877
+ /**
2878
+ * Çerezleri **yalnızca** yapılandırılmış API tabanlarına ekler.
2879
+ *
2880
+ * 🔴 Koşulsuz `withCredentials` bir güvenlik hatasıdır: KC discovery gibi dış
2881
+ * çağrılar da bu zincirden geçiyor ve oturum çerezi üçüncü tarafa giderdi.
2882
+ */
2883
+ declare class VpWithCredentialsInterceptor implements HttpInterceptor {
2884
+ private readonly bases;
2885
+ constructor(bases: readonly string[]);
2886
+ intercept(req: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;
2887
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpWithCredentialsInterceptor, never>;
2888
+ static ɵprov: i0.ɵɵInjectableDeclaration<VpWithCredentialsInterceptor>;
2889
+ }
2890
+ interface VpAuthCoreConfig {
2891
+ /** Bu uygulamanın AppKey'i. 7 hane; literal yazma, `AppKeyRegistry` karşılığını kullan. */
2892
+ appKey: string;
2893
+ /** Çerez taşınacak API tabanları. Verilmezse `withCredentials` interceptor'ı kaydedilmez. */
2894
+ apiBaseUrls?: readonly string[];
2895
+ csrfPort?: Type<VpCsrfPort>;
2896
+ authTokenPort?: Type<VpAuthTokenPort>;
2897
+ requestContextPort?: Type<VpRequestContextPort>;
2898
+ maintenancePort?: Type<VpMaintenancePort>;
2899
+ }
2900
+ /**
2901
+ * Konsol interceptor zincirini kurar.
2902
+ *
2903
+ * 🔴 Portu verilmeyen interceptor **kaydedilmez**. Boş bir port varsayılanıyla
2904
+ * kaydetmek "zincirde duruyor ama hiçbir şey yapmıyor" durumunu üretirdi — Prime'ın
2905
+ * `NetworkInterceptor`'ı tam olarak bu (27 satır, gövdesi boş bir `if`, davranışı
2906
+ * kimlik fonksiyonu). Eksik yapılandırma görünür kalmalı.
2907
+ *
2908
+ * Kayıt sırası `VP_AUTH_CHAIN_ORDER`'dan türetilir; ikinci bir liste tutulmaz.
2909
+ */
2910
+ declare function provideVpAuthCore(config: VpAuthCoreConfig): Provider[];
2911
+
2912
+ /**
2913
+ * Paket 10 · G3/G9/G10 — konsol guard'ları.
2914
+ *
2915
+ * ## Ortak kural: bilgi yokken karar verme
2916
+ *
2917
+ * Üçünün de en önemli davranışı "bilmiyorum" durumunda **engellememek**. Guard
2918
+ * kullanıcıyı korumak için var; belirsizlikte kapıyı kapatan bir guard, korumaya
2919
+ * çalıştığı kullanıcıya zarar verir. Bu ders Prime'ın `riskGuard`'ından geliyor:
2920
+ * tracker okuması hata verince istisna yutuluyor ve akış risk değerlendirmesine
2921
+ * devam ediyordu — warm-up koruması atlanıp kullanıcı engellenebiliyordu.
2922
+ *
2923
+ * Zorlayıcı taraf her zaman sunucu. `ScanManagerOwnershipTests` sahipliği,
2924
+ * `BillingGraceEnforcer` kotayı zaten zorluyor. Buradaki guard'lar bir **UX**
2925
+ * katmanı: kullanıcı boş ekran yerine sebebini görüyor.
2926
+ */
2927
+ /**
2928
+ * Oturum durumu.
2929
+ *
2930
+ * 🔴 `unknown` ayrı bir durum olmak zorunda. `checkAuth()` bootstrap'ta çözülene
2931
+ * kadar cevap yok; bu anı `anonymous` saymak sayfa her yenilendiğinde giriş yapmış
2932
+ * kullanıcıyı login'e atar. İki değerli bir bayrak (`isAuthenticated: boolean`) bu
2933
+ * hatayı yapısal olarak kaçınılmaz kılardı.
2934
+ */
2935
+ type VpAuthState = 'unknown' | 'authenticated' | 'anonymous';
2936
+ interface VpAuthSessionPort {
2937
+ readState(): VpAuthState;
2938
+ }
2939
+ type VpOwnershipVerdict = 'owned' | 'foreign' | 'unknown';
2940
+ interface VpOwnershipPort {
2941
+ check(resourceId: string): Observable<VpOwnershipVerdict>;
2942
+ }
2943
+ interface VpQuotaSnapshot {
2944
+ remaining: number;
2945
+ limit: number;
2946
+ }
2947
+ interface VpQuotaPort {
2948
+ /** `null` = okunamadı. `{ remaining: 0 }` = ölçüldü ve bitti. İkisi aynı şey değil. */
2949
+ read(): Observable<VpQuotaSnapshot | null>;
2950
+ }
2951
+ interface VpConsoleGuardRoutes {
2952
+ login: string;
2953
+ forbidden: string;
2954
+ quotaExhausted: string;
2955
+ }
2956
+ declare const VP_AUTH_SESSION_PORT: InjectionToken<VpAuthSessionPort>;
2957
+ declare const VP_OWNERSHIP_PORT: InjectionToken<VpOwnershipPort>;
2958
+ declare const VP_QUOTA_PORT: InjectionToken<VpQuotaPort>;
2959
+ declare const VP_CONSOLE_GUARD_ROUTES: InjectionToken<VpConsoleGuardRoutes>;
2960
+ /**
2961
+ * Giriş yapmamış kullanıcıyı login'e yollar.
2962
+ *
2963
+ * Port bağlanmamışsa **patlar**. Sessizce `true` dönseydi kimlik doğrulaması
2964
+ * olmayan bir konsol yeşil testlerle üretime çıkardı — guard'ın açık kapıya
2965
+ * dönüşmesi, guard'ın hiç olmamasından kötüdür çünkü var sanılır.
2966
+ */
2967
+ declare const vpAuthGuard: CanActivateFn;
2968
+ /**
2969
+ * Başkasının kaynağına erişimi engeller.
2970
+ *
2971
+ * Prime'ın 18 guard'ının hiçbiri bunu yapmıyor; sahiplik yalnızca sunucuda.
2972
+ */
2973
+ declare const vpOwnershipGuard: CanActivateFn;
2974
+ /**
2975
+ * Kota bittiğinde tarama başlatmayı engeller ve sebebini gösterir.
2976
+ *
2977
+ * 🔴 `0` ile `null` ayrı: biri "ölçüldü ve bitti", diğeri "bilinmiyor". Aynı
2978
+ * davranışı verselerdi ya kota bitmiş kullanıcı sessizce geçerdi ya da kota
2979
+ * servisi bir dakika yavaşladığında ürünün tamamı kilitlenirdi.
2980
+ */
2981
+ declare const vpQuotaGuard: CanActivateFn;
2982
+ interface VpConsoleGuardConfig {
2983
+ routes: VpConsoleGuardRoutes;
2984
+ authSessionPort?: Type<VpAuthSessionPort>;
2985
+ ownershipPort?: Type<VpOwnershipPort>;
2986
+ quotaPort?: Type<VpQuotaPort>;
2987
+ }
2988
+ /**
2989
+ * Guard portlarını bağlar.
2990
+ *
2991
+ * Bağlanmayan port için **varsayılan sağlanmaz**: guard çağrıldığında Angular
2992
+ * `NullInjectorError` atar. Sessiz bir varsayılan, eksik yapılandırmayı çalışan
2993
+ * bir sistem gibi gösterirdi.
2994
+ */
2995
+ declare function provideVpConsoleGuards(config: VpConsoleGuardConfig): Provider[];
2996
+
2997
+ /**
2998
+ * Anon zincir sirasi — cekirdek siradan **turetiliyor**.
2999
+ *
3000
+ * 🔴 Ikinci bir elle yazilmis liste tutulmuyor. Iki liste olsaydi biri
3001
+ * guncellenip digeri unutuldugu gun "build calisiyor ama davranis degisti"
3002
+ * ciplak gozle gorulmezdi.
3003
+ */
3004
+ declare const VP_AUTH_ANON_CHAIN_ORDER: readonly string[];
3005
+ /** Paylasim baglantisindaki jeton. Yoksa `null`. */
3006
+ interface VpShareTokenPort {
3007
+ readShareToken(): string | null;
3008
+ }
3009
+ /**
3010
+ * hCaptcha jetonu. Yoksa `null`.
3011
+ *
3012
+ * 🔴 `consume` — `read` DEGIL. hCaptcha jetonu **tek kullanimlik**; sunucu
3013
+ * ayni jetonu ikinci kez gorurse replay sayip reddediyor. Prime'daki cagri
3014
+ * yeri de `consumeToken()` (`captcha-interceptor.ts`). `read` adiyla bir port,
3015
+ * uygulamanin jetonu tuketmeden dondurmesini davet ederdi ve ikinci istek
3016
+ * sessizce reddedilirdi — belirtisi "captcha calismyor" olurdu, sebebi
3017
+ * gorunmezdi.
3018
+ */
3019
+ interface VpCaptchaPort {
3020
+ consumeCaptchaToken(): string | null;
3021
+ }
3022
+ /** Anonim oturum jetonu (Prime'da `TrialAuthService`). */
3023
+ interface VpAnonTokenPort {
3024
+ readAnonToken(): string | null;
3025
+ }
3026
+ declare const VP_SHARE_TOKEN_PORT: InjectionToken<VpShareTokenPort>;
3027
+ declare const VP_CAPTCHA_PORT: InjectionToken<VpCaptchaPort>;
3028
+ declare const VP_ANON_TOKEN_PORT: InjectionToken<VpAnonTokenPort>;
3029
+ declare class VpCaptchaInterceptor implements HttpInterceptor {
3030
+ private readonly captcha;
3031
+ constructor(captcha: VpCaptchaPort);
3032
+ intercept(req: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;
3033
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpCaptchaInterceptor, never>;
3034
+ static ɵprov: i0.ɵɵInjectableDeclaration<VpCaptchaInterceptor>;
3035
+ }
3036
+ /**
3037
+ * Anonim oturum jetonu.
3038
+ *
3039
+ * 🔴 Mevcut `Authorization` basligini **ezmez**. Ezseydi devir sonrasi
3040
+ * (paket 14) kullanici kendi hesabina girmis olur ama istekleri hala anonim
3041
+ * kimlikle giderdi — sunucu reddetmez, yanlis kisinin verisini dondurur.
3042
+ */
3043
+ declare class VpAnonTokenInterceptor implements HttpInterceptor {
3044
+ private readonly anon;
3045
+ constructor(anon: VpAnonTokenPort);
3046
+ intercept(req: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;
3047
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpAnonTokenInterceptor, never>;
3048
+ static ɵprov: i0.ɵɵInjectableDeclaration<VpAnonTokenInterceptor>;
3049
+ }
3050
+ /**
3051
+ * Paylasim baglantisi jetonu.
3052
+ *
3053
+ * ⚠️ Mevcut basligin **uzerine yaziyor** ve bu bilerek: paylasilan bir tarama
3054
+ * baglantisini acan kisi, giris yapmis olsa bile o baglantinin kimligiyle
3055
+ * bakiyor. Prime'daki davranis bu (`headers.set`); burada degistirmek tasima
3056
+ * degil, sessiz bir urun karari olurdu.
3057
+ */
3058
+ declare class VpShareTokenInterceptor implements HttpInterceptor {
3059
+ private readonly share;
3060
+ constructor(share: VpShareTokenPort);
3061
+ intercept(req: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;
3062
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpShareTokenInterceptor, never>;
3063
+ static ɵprov: i0.ɵɵInjectableDeclaration<VpShareTokenInterceptor>;
3064
+ }
3065
+ interface VpAuthAnonConfig {
3066
+ shareTokenPort?: Type<VpShareTokenPort>;
3067
+ captchaPort?: Type<VpCaptchaPort>;
3068
+ anonTokenPort?: Type<VpAnonTokenPort>;
3069
+ }
3070
+ /**
3071
+ * Anonim ziyaretci interceptor'larini kurar.
3072
+ *
3073
+ * Cekirdekteki kuralin aynisi: **portu verilmeyen interceptor kaydedilmez.**
3074
+ * Bos varsayilanla kaydetmek "zincirde duruyor ama hicbir sey yapmiyor"
3075
+ * durumunu uretir ve eksik yapilandirma gorunmez olur.
3076
+ */
3077
+ declare function provideVpAuthAnon(config: VpAuthAnonConfig): Provider[];
3078
+
3079
+ /**
3080
+ * Yonlendirme adresi dogrulamasi — paket 10 · T1.
3081
+ *
3082
+ * OWASP A10:2021 (SSRF) · A01:2021 (bozuk erisim denetimi).
3083
+ *
3084
+ * 🔴 Bu kontrol Prime'da yasiyordu ve trial Customer Console'a tasindiginda
3085
+ * orada da gerekiyor. **Kopyalanmadi, tasindi**: bir guvenlik denetiminin iki
3086
+ * kopyasi, biri sertlestirilip digeri unutuldugunda "ayni urun, iki farkli
3087
+ * kapi" demektir.
3088
+ *
3089
+ * ⚠️ Sunucu kanonik allowlist'i zaten uyguluyor. Bu katman UI hatalarina ve
3090
+ * DOM tabanli acik yonlendirmeye karsi ikinci savunma — tek basina yeterli
3091
+ * degil, tek basina birakilmamali.
3092
+ *
3093
+ * ⚠️ `environment` import EDILMIYOR. Prime'daki kopya ortam dosyasini dogrudan
3094
+ * okuyordu ve bu yuzden yalniz o uygulamada calisiyordu. Politika parametre
3095
+ * olarak geliyor; paket SSR'da ve testte de ayni.
3096
+ */
3097
+ /** ReDoS/DoS savunmasi: ayristirmadan ONCE bakiliyor. */
3098
+ declare const VP_REDIRECT_MAX_LENGTH = 2048;
3099
+ interface VpRedirectPolicy {
3100
+ /** Gelistirme: `http` ve loopback kabul edilir. Uretimde `false`. */
3101
+ allowInsecureLocalhost: boolean;
3102
+ /** Yapilandirilmis callback. Verilmezse eslesme kontrolu YAPILMAZ. */
3103
+ configuredCallback?: string | null;
3104
+ }
3105
+ interface VpRedirectUriVerdict {
3106
+ valid: boolean;
3107
+ /** Ret sebebi. "Reddedildi" tek basina hata ayiklanamaz. */
3108
+ reason?: string;
3109
+ }
3110
+ /**
3111
+ * Uygulanan kurallar:
3112
+ * 1. Mutlak URL
3113
+ * 2. `https` (gelistirmede localhost icin `http`)
3114
+ * 3. IP adresi yok (ic aga SSRF)
3115
+ * 4. Ozel / ayrilmis aralik yok
3116
+ * 5. Meta veri ucu yok
3117
+ * 6. Kullanici bilgisi yok (kimlik avi)
3118
+ * 7. Parca yok (OAuth 2.0 §3.1.2)
3119
+ * 8. Yapilandirilmis callback ile eslesir
3120
+ */
3121
+ declare function validateVpRedirectUri(uri: string | null | undefined, policy: VpRedirectPolicy): VpRedirectUriVerdict;
3122
+
3123
+ /**
3124
+ * Anonim kimligin turetilmesi — paket 10 · T1.
3125
+ *
3126
+ * 🔴 Turetim **belirlenimci** olmak zorunda: ayni cihaz her seferinde ayni
3127
+ * anon kimligi uretmeli. Iki uygulama farkli turetirse (Prime bir formul,
3128
+ * konsol baska bir formul) ayni ziyaretci iki kimlik alir ve taramalari ikiye
3129
+ * bolunur. Hicbir yerde hata cikmaz — kullanici yalnizca taramalarinin
3130
+ * "kayboldugunu" gorur.
3131
+ *
3132
+ * Bu yuzden Prime'daki formul **birebir** tasindi ve girdi bicimi testle
3133
+ * sabitlendi.
3134
+ */
3135
+ /** Ozetin ilk kac hanesi kullaniliyor (Prime ile ayni). */
3136
+ declare const VP_ANON_ID_HEX_LENGTH = 32;
3137
+ /** SHA-256 hex ozeti. Uretemezse `null` ya da bos dizge. */
3138
+ type VpSha256Hex = (input: string) => string | null;
3139
+ /**
3140
+ * Cihaz karmasi + tracking id'den anon kimlik turetir.
3141
+ *
3142
+ * @param override Zaten bilinen bir anon kimlik. Verilirse turetim YAPILMAZ.
3143
+ *
3144
+ * 🔴 Turetilemezse `null` donuyor, rastgele bir kimlik **uretmiyor**. Rastgele
3145
+ * kimlik cihazin onceki taramalarini kaybettirir; bu bir urun karari ve
3146
+ * cagiranin gorebilecegi yerde alinmali, yardimci fonksiyonun icinde sessizce
3147
+ * degil. Prime bu noktada rastgeleye dusuyor ve dustugu hicbir yerde yazmiyor.
3148
+ */
3149
+ declare function vpAnonIdFrom(deviceHash: string, trackingId: string, sha256Hex: VpSha256Hex, override?: string): string | null;
3150
+
3151
+ /**
3152
+ * Tracking id cozumu — paket 10 · T1.
3153
+ *
3154
+ * 🔴 Bu deger anon kimligin **girdisi** (`vp|dh:X|trk:Y`). Yanlis cozulurse
3155
+ * cihaz yeni bir tracking id alir, yeni tracking id yeni bir anon kimlik
3156
+ * uretir ve ziyaretcinin onceki taramalari baska bir kimligin altinda kalir.
3157
+ * Hicbir yerde hata cikmaz.
3158
+ *
3159
+ * ⚠️ Fonksiyon **IO yapmiyor**. Cerez/localStorage okuma ve yazma cagirana
3160
+ * ait; burada yalnizca karar var. Boylece kural tarayicisiz test edilebiliyor
3161
+ * ve "hangi depo kazandi" sorusu tek yerde cevaplaniyor.
3162
+ */
3163
+ /** Prime ile ayni: onbellek bir gun sonra gecersiz. */
3164
+ declare const VP_TRACKING_CACHE_TTL_MS: number;
3165
+ /**
3166
+ * Gecerli GUID ise **kucuk harfe cevrilmis** hali, degilse bos dizge.
3167
+ *
3168
+ * 🔴 Kucultme sart: anon turetimi dizgeyi oldugu gibi ozetliyor, dolayisiyla
3169
+ * `ABC...` ile `abc...` ayni cihaz icin iki farkli anon kimlik uretirdi.
3170
+ */
3171
+ declare function vpEnsureGuid(value: string | null | undefined): string;
3172
+ /** Yerel onbellekteki kayit. Cihaza **bagli**. */
3173
+ interface VpTrackingCache {
3174
+ dh: string;
3175
+ trk: string;
3176
+ /** Yazilma ani (ms). `0` = bilinmiyor -> gecersiz. */
3177
+ at: number;
3178
+ }
3179
+ interface VpTrackingInput {
3180
+ cookie: string | null | undefined;
3181
+ cached: VpTrackingCache | null | undefined;
3182
+ deviceHash: string;
3183
+ now: number;
3184
+ ttlMs?: number;
3185
+ }
3186
+ interface VpTrackingResolution {
3187
+ id: string | null;
3188
+ source: 'cookie' | 'cache' | null;
3189
+ /** Cagiran bunu cereze yazmali. */
3190
+ writeCookie: string | null;
3191
+ /** Cagiran bunu yerel onbellege yazmali. */
3192
+ writeCache: VpTrackingCache | null;
3193
+ /** Onbellek gecersiz — silinmeli. */
3194
+ clearCache: boolean;
3195
+ }
3196
+ /**
3197
+ * Oncelik: cerez > onbellek > (yok).
3198
+ *
3199
+ * 🔴 Kazanan hangisi olursa olsun **oteki de yaziliyor**. Yazilmasaydi iki
3200
+ * depo ayrisir ve cerez suresi doldugu gun eski onbellek geri gelerek cihazin
3201
+ * kimligini geriye dogru degistirirdi.
3202
+ *
3203
+ * Hicbir kaynak yoksa `null` donuyor; id **uydurulmuyor**. Uydurulsaydi
3204
+ * sunucunun verdigi kimlikle istemcininki ayrisirdi.
3205
+ */
3206
+ declare function vpResolveTrackingId(input: VpTrackingInput): VpTrackingResolution;
3207
+
3208
+ /**
3209
+ * Cihaz karmasi — paket 10 · T1.
3210
+ *
3211
+ * 🔴 Kimlik zincirinin ilk halkasi:
3212
+ *
3213
+ * cihaz karmasi → tracking id onbellegi → anon kimlik
3214
+ *
3215
+ * Konsol karmayi Prime'dan farkli kurarsa ayni tarayici baska bir cihaz gibi
3216
+ * gorunur: tracking id onbellegi gecersiz olur, anon kimlik degisir ve
3217
+ * ziyaretcinin taramalari oksuz kalir. Hicbir yerde hata cikmaz.
3218
+ *
3219
+ * ⚠️ Sinyallerin **toplanmasi** burada degil. `navigator` okumak uygulamanin
3220
+ * isi; bu paketin isi bicimin her yerde ayni olmasi.
3221
+ */
3222
+ interface VpDeviceSignals {
3223
+ browser: string;
3224
+ os: string;
3225
+ language: string;
3226
+ hardwareConcurrency: number;
3227
+ isMobile: boolean;
3228
+ vendor: string;
3229
+ }
3230
+ /**
3231
+ * Ozetlenecek ham dizge.
3232
+ *
3233
+ * ⚠️ Alanlarin sirasi ve ayiraci **sozlesme**. Degistirmek ayni cihaz icin
3234
+ * baska bir karma uretir ve gecis gununde butun anonim ziyaretciler
3235
+ * kimliklerini kaybeder. Prime'daki bicim aynen korunuyor.
3236
+ */
3237
+ declare function vpDeviceRawData(s: VpDeviceSignals): string;
3238
+ /**
3239
+ * Sinyallerden cihaz karmasi.
3240
+ *
3241
+ * 🔴 Eksik sinyalde ya da ozet uretilemedigande `null` donuyor. Prime bos
3242
+ * dizge donuyor ve cagiran `if (!dh)` ile yakaliyor — ama bos dizge "karma
3243
+ * yok" ile "karma bos" arasini ayirmiyor. Eksik sinyal icin varsayilan bir
3244
+ * deger koymak ise iki farkli cihazi ayni karmaya dusurebilirdi.
3245
+ */
3246
+ declare function vpDeviceFingerprint(signals: VpDeviceSignals, sha256Hex: VpSha256Hex): string | null;
3247
+
3248
+ /**
3249
+ * Tarama tarih araligi — sunucunun kuralinin aynasi.
3250
+ *
3251
+ * `ScanManager.GetScansByDateRangeUser` iki sey dayatiyor:
3252
+ * - `end > start`
3253
+ * - aralik en fazla **1 ay**
3254
+ *
3255
+ * 🔴 Istemci bunlara onceden bakmazsa kullanici, alanin yaninda bir uyari
3256
+ * yerine sunucudan donen bir hata cumlesi goruyor ve o cumle hangi alani
3257
+ * duzeltecegini soylemiyor.
3258
+ *
3259
+ * ⚠️ Kural bilerek iki yerde: sunucu **zorluyor**, istemci **acikliyor**.
3260
+ * Istemci tarafi bir guvenlik siniri degil; kaldirilirsa veri sizmaz, yalniz
3261
+ * kullanici sebebini goremez.
3262
+ */
3263
+ /** Sunucudaki `start.AddMonths(1)` ile ayni. */
3264
+ declare const VP_SCAN_RANGE_MAX_MONTHS = 1;
3265
+ interface VpScanRangeVerdict {
3266
+ valid: boolean;
3267
+ /** Ret sebebi. "Gecersiz" tek basina duzeltilemez. */
3268
+ reason?: string;
3269
+ }
3270
+ /**
3271
+ * @param startMs Baslangic (epoch ms)
3272
+ * @param endMs Bitis (epoch ms)
3273
+ */
3274
+ declare function validateVpScanDateRange(startMs: number, endMs: number): VpScanRangeVerdict;
3275
+
3276
+ /**
3277
+ * `/trial/**` → konsol yönlendirme haritası.
3278
+ *
3279
+ * Paket 11 · trial devri — silmeden **önceki** son adımın verisi.
3280
+ *
3281
+ * 🔴 **Bu dosya `@virusis/angular-ui`'de, iki depoda değil.** Hem Prime (yönlendiren)
3282
+ * hem Customer Console (hedef) aynı haritaya bakıyor. İki kopya olsaydı biri
3283
+ * güncellenip diğeri unutulduğunda fark **sessiz** kalırdı: kullanıcı 404 görür,
3284
+ * kimse bir şey değiştirmediğini sanar. nginx kuralı da bu haritadan üretiliyor —
3285
+ * üç yer, tek kaynak.
3286
+ *
3287
+ * 🔴 Bu harita tek kaynak. Yönlendirme kuralı (nginx/Cloudflare) elle
3288
+ * yazılırsa iki liste olur ve biri güncellenip diğeri unutulduğunda **fark
3289
+ * sessiz** kalır: kullanıcı 404 görür, kimse bir şey değiştirmediğini sanır.
3290
+ * Buradaki tablo test edilebiliyor ve kuralın kaynağı olabiliyor.
3291
+ *
3292
+ * ⚠️ Yönlendirme **301 (kalıcı)**. Paylaşım bağlantıları kullanıcıların
3293
+ * elinde ve dışarıda; 302 verilseydi tarayıcılar ve arama motorları eski adresi
3294
+ * canlı saymaya devam ederdi.
3295
+ *
3296
+ * 🔴 **Sorgu dizesi korunuyor.** `/trial/scan-data-result/:guid/share`
3297
+ * kimliği `?credential=` ile taşıyor; atılırsa dışarıdaki her paylaşım
3298
+ * bağlantısı, yönlendirme çalışsa bile **anlamsız** bir sayfaya varır.
3299
+ */
3300
+ interface TrialRouteRule {
3301
+ /** Prime'daki yol — `:guid` yer tutucusu ile. */
3302
+ from: string;
3303
+ /** Konsoldaki karşılığı. */
3304
+ to: string;
3305
+ /** Neden bu hedef — kararın kendisi kadar önemli. */
3306
+ reason: string;
3307
+ }
3308
+ /**
3309
+ * Sırayla eşleştiriliyor: **daha uzun/özel yol önce**.
3310
+ *
3311
+ * 🔴 `scan-data-result/:guid/share` kuralı `scan-data-result/:guid`'den önce
3312
+ * gelmek zorunda. Ters sırada paylaşım yolu genel kurala takılır, `/share`
3313
+ * eki yok sayılır ve kimlik hiç okunmaz.
3314
+ */
3315
+ declare const TRIAL_ROUTE_MAP: readonly TrialRouteRule[];
3316
+ interface RedirectTarget {
3317
+ path: string;
3318
+ /** Kaynaktaki sorgu dizesi (varsa) — olduğu gibi taşınıyor. */
3319
+ query: string;
3320
+ }
3321
+ /**
3322
+ * Bir trial yolunu konsol yoluna çevirir.
3323
+ *
3324
+ * @param url `/trial/...` biçiminde yol; sorgu dizesi taşıyabilir.
3325
+ * @returns Hedef, ya da trial yolu değilse `null`.
3326
+ */
3327
+ declare function resolveTrialRedirect(url: string | null | undefined): RedirectTarget | null;
3328
+
3329
+ /**
3330
+ * Girişten ÖNCE sağlık kapısı — dört konsol için ortak.
3331
+ *
3332
+ * 🔴 Neden gerekli: Keycloak'a yönlendirme **tam sayfa** bir gezinmedir.
3333
+ * Uygulama oradan çıkar. KC ya da arka uç ayakta değilse kullanıcı bizim
3334
+ * kontrolümüzde olmayan bir hata sayfasında kalır — geri dönmenin yolu yok,
3335
+ * ne olduğunu söyleyen bir mesaj yok. Konsol "bozuk" görünür ama bozuk olan
3336
+ * konsol değildir.
3337
+ *
3338
+ * Bu yüzden kapı **yönlendirmeden önce** çalışır: hâlâ bizim sayfamızdayken
3339
+ * sorulur, cevap kötüyse kendi ekranımız gösterilir.
3340
+ *
3341
+ * ⚠️ İKİ ayrı şey sorulur ve ikisi de gereklidir:
3342
+ *
3343
+ * 1. **Arka uç** — konsolun verisi oradan geliyor.
3344
+ * 2. **Keycloak** — giriş oraya gidiyor.
3345
+ *
3346
+ * Yalnız birini sormak, diğerinin çöktüğü durumu tam da en kötü anda kaçırır:
3347
+ * arka uç sağlıklıyken KC kapalıysa kullanıcı yine KC'nin hata sayfasında
3348
+ * kalır ve biz "her şey yolunda" demiş oluruz.
3349
+ */
3350
+ type VpHealthVerdict = 'healthy' | 'backend-down' | 'auth-down' | 'both-down';
3351
+ interface VpAuthHealthConfig {
3352
+ /** Arka uç sağlık ucu — göreli olabilir (`/api/health`). */
3353
+ backendHealthUrl: string;
3354
+ /**
3355
+ * Keycloak keşif belgesi. `authority` + `/.well-known/openid-configuration`.
3356
+ *
3357
+ * 📌 Ayrı bir "KC sağlık" ucu YOK ve olmasına gerek de yok: keşif belgesi
3358
+ * OIDC istemcisinin zaten ilk indirdiği şey. Ulaşılamıyorsa giriş de
3359
+ * yapılamaz — yani doğrudan cevabı aradığımız soru bu.
3360
+ */
3361
+ authDiscoveryUrl: string;
3362
+ /**
3363
+ * Cevap beklenen süre.
3364
+ *
3365
+ * ⚠️ Sınırsız beklemek en kötü seçenek: kullanıcı boş bir ekranda kalır ve
3366
+ * hiçbir şey söylenmez. Cevapsızlık da bir cevaptır — "ayakta değil" sayılır.
3367
+ */
3368
+ timeoutMs: number;
3369
+ /** Sağlıksızken gidilecek rota. */
3370
+ unavailableRoute: string;
3371
+ }
3372
+ declare const VP_AUTH_HEALTH_CONFIG: InjectionToken<VpAuthHealthConfig>;
3373
+ /** İki cevaptan tek karar. */
3374
+ declare function verdictFor(backendOk: boolean, authOk: boolean): VpHealthVerdict;
3375
+ /**
3376
+ * Kullanıcıya gösterilecek metin.
3377
+ *
3378
+ * 🔴 Üç durum AYRI: "giriş servisi kapalı" ile "arka uç kapalı" farklı şeyler
3379
+ * ve kullanıcının yapacağı şey de farklı. Tek bir "bir şeyler ters gitti"
3380
+ * mesajı, destek çağrısında hiçbir bilgi taşımaz.
3381
+ */
3382
+ declare function messageFor(verdict: VpHealthVerdict): {
3383
+ title: string;
3384
+ description: string;
3385
+ };
3386
+ /**
3387
+ * Bir durum kodu "servis ayakta" mı demek.
3388
+ *
3389
+ * 🔴 İlk sürüm **her** cevabı ayakta sayıyordu ("cevap verdi, demek ki
3390
+ * ayakta"). Ölçüm bunun neden yetmediğini gösterdi: sağlık ucu yanlışlıkla
3391
+ * `/api/health` olarak yapılandırılmıştı ve gerçek uç `/health` (kökte).
3392
+ * `/api/health` **404** dönüyordu — ve o kural 404'ü "sağlıklı" sayıyordu.
3393
+ * Yani yanlış adres soran bir kapı, kendini yeşil gösteriyordu.
3394
+ *
3395
+ * ⚠️ `401`/`403` ayakta SAYILIR: servis cevap veriyor, yalnız kimlik istiyor.
3396
+ * Sağlık ucu korumalıysa bu tek doğru okuma.
3397
+ *
3398
+ * `404` ayakta sayılmaz: sorduğumuz şey orada yok. Bu bir yapılandırma
3399
+ * hatasıdır ve sessizce yeşil geçmemeli.
3400
+ */
3401
+ declare function isUpStatus(status: number): boolean;
3402
+ /**
3403
+ * Girişe gitmeden önce çalışan kapı.
3404
+ *
3405
+ * ⚠️ Bu guard giriş rotasına konur, korunan rotalara DEĞİL. Korunan rotaya
3406
+ * konsaydı her gezinmede iki ağ isteği eklenirdi.
3407
+ */
3408
+ declare const vpAuthHealthGuard: CanActivateFn;
3409
+ /** İki ucu **paralel** sorar — sıralı sorsaydı en kötü durumda süre iki katına çıkardı. */
3410
+ declare function checkBoth(http: HttpClient, cfg: VpAuthHealthConfig): Observable<VpHealthVerdict>;
3411
+
3412
+ /**
3413
+ * İsteğin bizim kökenimize gidip gitmediği.
3414
+ *
3415
+ * 🔴 Bu dosya bir üretim hatasından doğdu (2026-08-26, Customer Console dev):
3416
+ *
3417
+ * Access to XMLHttpRequest at
3418
+ * 'https://auth.virusis.com/realms/.../.well-known/openid-configuration'
3419
+ * from origin 'http://localhost:4500' has been blocked by CORS policy:
3420
+ * Request header field x-app-key is not allowed by Access-Control-Allow-Headers
3421
+ *
3422
+ * `VpAppKeyInterceptor` `X-App-Key`'i **her** isteğe ekliyordu — Keycloak'ın
3423
+ * keşif belgesine de. Keycloak o başlığı tanımıyor, tarayıcı preflight'ı
3424
+ * reddediyor ve **giriş hiç başlamıyor**.
3425
+ *
3426
+ * ⚠️ Ama asıl mesele CORS değil. `VpAuthTokenInterceptor` de aynı şeyi
3427
+ * yapıyordu: `Authorization: Bearer <token>` başlığını **hangi kökene giderse
3428
+ * gitsin** ekliyordu. Yani üçüncü taraf bir adrese yapılan her istek bizim
3429
+ * erişim jetonumuzu taşıyordu. CORS hatası burada bir şans: gürültü çıkarıp
3430
+ * sessiz bir jeton sızıntısını görünür yaptı.
3431
+ *
3432
+ * 📌 Prime bu dersi ayrı ayrı öğrenmişti (`interceptor` dış URL atlaması);
3433
+ * tasarım sistemi öğrenmemişti. Artık tek yerde.
3434
+ */
3435
+ /**
3436
+ * Göreli yollar HER ZAMAN bizim kökenimizdir (`/api/...`, `health`).
3437
+ * Mutlak adresler yalnız köken eşleşiyorsa.
3438
+ *
3439
+ * ⚠️ Ayrıştırılamayan bir adres **yabancı sayılır**. Ters varsayım, tanımadığımız
3440
+ * bir şeye başlık eklemek olurdu — ve bu başlıklardan biri jeton taşıyor.
3441
+ */
3442
+ declare function isSameOrigin(url: string, selfOrigin: string): boolean;
3443
+ /**
3444
+ * Tarayıcıdaki geçerli köken.
3445
+ *
3446
+ * SSR/test ortamında `window` yok; o durumda **hiçbir şey aynı köken
3447
+ * sayılmasın** diye boş dize dönüyor — göreli yollar zaten yukarıda
3448
+ * yakalanıyor, mutlak adresler ise başlık almıyor.
3449
+ */
3450
+ declare function currentOrigin(): string;
3451
+
3452
+ /**
3453
+ * Giriş SONRASI derin sağlık — `GET /api/diagnostics/infra-health`.
3454
+ *
3455
+ * Giriş öncesi kapı (`vpAuthHealthGuard`) "ayakta mı" sorusunu soruyor.
3456
+ * Bu ise "sağlıklı mı" sorusunu: her bileşen için canlılık ve gecikme.
3457
+ * İkisi farklı sorular ve farklı anlarda sorulur.
3458
+ *
3459
+ * 🔴 Uç nokta `[Authorize(Roles = "Admin,Developer")]` ile korunuyor.
3460
+ * Customer konsolunun kullanıcıları `User` rolüyle geliyor — yani onlar için
3461
+ * cevap **her zaman 403**. Bu yüzden 403 "sağlıksız" SAYILMAZ:
3462
+ *
3463
+ * 403 → `not-permitted` (soru bu kullanıcıya kapalı; söylenecek bir şey yok)
3464
+ * 200 → rapordaki `status`
3465
+ * diğer / ağ hatası → `unknown`
3466
+ *
3467
+ * ⚠️ Ayrım olmasaydı her müşteriye kalıcı bir "sistem bozuk" uyarısı
3468
+ * gösterilirdi — hiçbir şey bozuk değilken. Yanlış alarm, alarmın kendisini
3469
+ * işe yaramaz yapar.
3470
+ */
3471
+ type VpDeepHealthState = 'healthy' | 'degraded' | 'unhealthy' | 'not-permitted' | 'unknown';
3472
+ interface VpComponentHealth {
3473
+ name: string;
3474
+ status: string;
3475
+ latencyMs: number;
3476
+ detail?: string | null;
3477
+ }
3478
+ interface VpDeepHealthResult {
3479
+ state: VpDeepHealthState;
3480
+ /** Yalnız `healthy`/`degraded`/`unhealthy` durumunda dolu. */
3481
+ components: readonly VpComponentHealth[];
3482
+ checkedAtUtc?: string;
3483
+ }
3484
+ interface VpDeepHealthConfig {
3485
+ /** `/api/diagnostics/infra-health` */
3486
+ url: string;
3487
+ timeoutMs: number;
3488
+ }
3489
+ declare const VP_DEEP_HEALTH_CONFIG: InjectionToken<VpDeepHealthConfig>;
3490
+ /**
3491
+ * Backend `InfraHealthReport.Status` değerini istemci durumuna çevirir.
3492
+ *
3493
+ * ⚠️ Bilinmeyen bir değer `unknown` olur, `healthy` DEĞİL. Tanımadığımız bir
3494
+ * cevabı iyi saymak, sessizce yanlış güven üretir.
3495
+ */
3496
+ declare function toDeepState(status: string | null | undefined): VpDeepHealthState;
3497
+ /** Kullanıcıya gösterilmeli mi. */
3498
+ declare function shouldSurface(state: VpDeepHealthState): boolean;
3499
+ declare class VpDeepHealthService {
3500
+ private readonly http;
3501
+ private readonly cfg;
3502
+ constructor(http: HttpClient, cfg: VpDeepHealthConfig);
3503
+ check(): Observable<VpDeepHealthResult>;
3504
+ static ɵfac: i0.ɵɵFactoryDeclaration<VpDeepHealthService, never>;
3505
+ static ɵprov: i0.ɵɵInjectableDeclaration<VpDeepHealthService>;
3506
+ }
3507
+
3508
+ export { CONVERSION_MOMENTS, MAX_CONVERSION_PROMPTS_PER_SESSION, TRIAL_ROUTE_MAP, UTF8_BOM, VP_ANON_ID_HEX_LENGTH, VP_ANON_TOKEN_PORT, VP_API_BASE_URLS, VP_APP_KEY, VP_AUTH_ANON_CHAIN_ORDER, VP_AUTH_CHAIN_ORDER, VP_AUTH_HEALTH_CONFIG, VP_AUTH_SESSION_PORT, VP_AUTH_TOKEN_PORT, VP_CAPTCHA_PORT, VP_CONSOLE_GUARD_ROUTES, VP_CSRF_PORT, VP_DARK_CLASS, VP_DEEP_HEALTH_CONFIG, VP_I18N_NAMESPACE, VP_ICON_SPRITE_ID, VP_MAINTENANCE_PORT, VP_OWNERSHIP_PORT, VP_QUOTA_PORT, VP_REDIRECT_MAX_LENGTH, VP_REQUEST_CONTEXT_PORT, VP_SAVED_VIEW_STORE, VP_SCAN_RANGE_MAX_MONTHS, VP_SHARE_TOKEN_PORT, VP_STATE_VARIANTS, VP_TABLE_PREFS_STORE, VP_THEME_STORAGE_KEY, VP_TRACKING_CACHE_TTL_MS, VP_UNSAVED_CHANGES_CONFIRM, VirusisUiModule, VpAnonTokenInterceptor, VpAppKeyInterceptor, VpAppealFormComponent, VpAuthTokenInterceptor, VpBannerComponent, VpBreadcrumbComponent, VpCaptchaInterceptor, VpCommandPaletteComponent, VpConfirmComponent, VpContextToolbarComponent, VpCsrfInterceptor, VpDangerZoneComponent, VpDataTableComponent, VpDeepHealthService, VpDetectionRowComponent, VpDialogComponent, VpDrawerComponent, VpEngineResultComponent, VpFieldComponent, VpGlobalLayersComponent, VpHashValueComponent, VpHttpIdsInterceptor, VpIconSpriteService, VpIocListComponent, VpKpiCardComponent, VpMaintenanceInterceptor, VpMenuButtonComponent, VpNotificationTriggerComponent, VpPageHeaderComponent, VpProductSwitcherComponent, VpRiskScoreComponent, VpSaveBarComponent, VpScanTimelineComponent, VpScoreBreakdownComponent, VpSearchTriggerComponent, VpSettingsShellComponent, VpSeverityBadgeComponent, VpShareTokenInterceptor, VpShellComponent, VpSidebarComponent, VpSidebarToggleComponent, VpSkipLinkComponent, VpStateComponent, VpThemeControlComponent, VpThemeService, VpToastComponent, VpToastService, VpTopbarComponent, VpUserMenuComponent, VpVerdictComponent, VpWithCredentialsInterceptor, checkBoth, collectRxBindings, conversionOfferFor, createFocusTrap, createLocalStoragePrefsStore, createLocalStorageViewStore, createScanAnnouncer, createTabSync, currentOrigin, defaultConditionDescriber, defineStaticMenu, findEmptyValues, findMissingKeys, findView, flattenKeys, focusableElements, formatCountdown, formatParityReport, isConditionMet, isPartialFailure, isSameOrigin, isUpStatus, mergeStageUpdate, messageFor, nextPrompt, provideVirusisApiClient, provideVpAuthAnon, provideVpAuthCore, provideVpConsoleGuards, reconcileColumnOrder, registerUnsavedChangesPrompt, removeView, resolveMenuConditions, resolveTrialRedirect, rxServiceKeyOf, shouldSurface, toCsv, toDeepState, toMenuItems, unmatchedRxClasses, upsertView, validateStaticMenu, validateVpRedirectUri, validateVpScanDateRange, verdictFor, visibleColumns, vpAnonIdFrom, vpAuthChainSlotOf, vpAuthGuard, vpAuthHealthGuard, vpAutoDismissMs, vpDeviceFingerprint, vpDeviceRawData, vpEnsureGuid, vpKey, vpOwnershipGuard, vpQuotaGuard, vpResolveTrackingId, vpUnsavedChangesGuard };
3509
+ export type { RedirectTarget, TrialRouteRule, VpAnnouncement, VpAnonTokenPort, VpApiClientProviderOptions, VpAppealSubmission, VpAuthAnonConfig, VpAuthChainSlot, VpAuthCoreConfig, VpAuthHealthConfig, VpAuthSessionPort, VpAuthState, VpAuthTokenPort, VpBannerTone, VpBulkAction, VpBulkFailure, VpBulkRequest, VpBulkResult, VpCaptchaPort, VpColumn, VpCommandItem, VpComponentHealth, VpConditionDescriber, VpConditionalMenuItem, VpConfirmResult, VpConfirmTone, VpConsoleGuardConfig, VpConsoleGuardRoutes, VpConversionMoment, VpCrumb, VpCsrfPort, VpCsvOptions, VpDeepHealthConfig, VpDeepHealthResult, VpDeepHealthState, VpDeviceSignals, VpEvidenceKind, VpExportRequest, VpExportScope, VpFocusTrap, VpHealthVerdict, VpIoc, VpIocType, VpKeyParity, VpMaintenancePort, VpMaintenanceSignal, VpMenuCapabilities, VpMenuCondition, VpMenuConditionKind, VpMenuItem, VpNotificationEntry, VpOwnershipPort, VpOwnershipVerdict, VpProduct, VpPromptContext, VpPromptKind, VpPromptPresentation, VpQuotaPort, VpQuotaSnapshot, VpQuotaState, VpRedirectPolicy, VpRedirectUriVerdict, VpRequestContextPort, VpRxBinding, VpSavedView, VpSavedViewStore, VpScanAnnouncer, VpScanPhaseKind, VpScanProgress, VpScanRangeVerdict, VpScanStage, VpScoreEvidence, VpSettingsSection, VpSha256Hex, VpShareTokenPort, VpStageState, VpStateAction, VpStateTone, VpStateType, VpStateVariant, VpStaticMenuIssue, VpTabMessage, VpTabSync, VpTabSyncOptions, VpTableColumnPrefs, VpTableLoadEvent, VpTablePrefsStore, VpThemeMode, VpToast, VpToastTone, VpTrackingCache, VpTrackingInput, VpTrackingResolution, VpTranslations, VpUnsavedChanges, VpVerdictKind };
3510
+ //# sourceMappingURL=index.d.ts.map