@konce-pt/angular 0.15.1 → 0.16.1

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@konce-pt/angular",
3
- "version": "0.15.1",
3
+ "version": "0.16.1",
4
4
  "description": "Open-source Angular 22 component library on Signals & Signal Forms - 70+ components, rich data table, zoneless, fully tokenized. Selektory kpt-*, klasy Kpt*.",
5
5
  "license": "MIT",
6
6
  "author": "konce.pt",
@@ -46,18 +46,18 @@
46
46
  },
47
47
  "dependencies": {
48
48
  "tslib": "^2.3.0",
49
- "@konce-pt/datetime": "0.15.1",
50
- "@konce-pt/chat": "0.15.1",
51
- "@konce-pt/icons": "0.15.1",
52
- "@konce-pt/backdrop": "0.15.1",
53
- "@konce-pt/chart": "0.15.1",
54
- "@konce-pt/map": "0.15.1",
55
- "@konce-pt/mention": "0.15.1",
56
- "@konce-pt/roadmap": "0.15.1",
57
- "@konce-pt/speech": "0.15.1",
58
- "@konce-pt/table": "0.15.1",
59
- "@konce-pt/motion": "0.15.1",
60
- "@konce-pt/i18n": "0.15.1"
49
+ "@konce-pt/backdrop": "0.16.1",
50
+ "@konce-pt/chart": "0.16.1",
51
+ "@konce-pt/chat": "0.16.1",
52
+ "@konce-pt/icons": "0.16.1",
53
+ "@konce-pt/map": "0.16.1",
54
+ "@konce-pt/mention": "0.16.1",
55
+ "@konce-pt/motion": "0.16.1",
56
+ "@konce-pt/speech": "0.16.1",
57
+ "@konce-pt/roadmap": "0.16.1",
58
+ "@konce-pt/table": "0.16.1",
59
+ "@konce-pt/datetime": "0.16.1",
60
+ "@konce-pt/i18n": "0.16.1"
61
61
  },
62
62
  "module": "fesm2022/konce-pt-angular.mjs",
63
63
  "typings": "types/konce-pt-angular.d.ts",
@@ -12,7 +12,8 @@ Import: `import { provideKptI18n, KptI18n } from '@konce-pt/angular';`
12
12
  - `locale: Signal<KptLocale>` - the current language.
13
13
  - `setLocale(locale)` - a runtime change (reactive across every component).
14
14
  - `registerMessages(locale, patch)` - adds to or overrides a dictionary at runtime.
15
- - `t(key, params?)` - translates a dotted key (`'paginator.range'`) with `{name}` interpolation.
15
+ - `t(key, params?)` - translates a dotted key (`'paginator.range'`) with `{name}` interpolation; ICU plural
16
+ blocks (`{count, plural, one {...} other {...}}`) follow the plural rules of the current `locale`.
16
17
 
17
18
  ## Adding your own language (one JSON file)
18
19
  import de from './i18n/de.json'; // the shape is the KptMessages interface
@@ -9,7 +9,8 @@ Import: `import { KptPeek, KptPeekTrigger } from '@konce-pt/angular';`
9
9
  - the element carrying the `kptPeekTrigger` attribute = the trigger; everything else = the card
10
10
 
11
11
  ## Inputs / outputs
12
- - `placement`: 'top' | 'bottom' (default 'bottom') - CDK flips it when there is no room
12
+ - `placement`: 'top' | 'bottom' (default 'bottom') - CDK flips it when there is no room; near the right edge of
13
+ the window the card opens leftwards, and when neither side fits it is pushed into view
13
14
  - `openDelay`: number (default 300) - the wait before hover opens the card
14
15
  - `closeDelay`: number (default 200) - the wait before leaving the trigger closes it
15
16
  - `disabled`: boolean - the card never opens; the trigger stays a plain link or button
@@ -5,8 +5,12 @@ Requires `import '@angular/cdk/overlay-prebuilt.css';`
5
5
  Import: `import { KptPopover } from '@konce-pt/angular';`
6
6
 
7
7
  ## Inputs / model
8
- - `placement`: 'bottom' | 'top' (default 'bottom') - the preferred side; CDK flips it when there is no room
8
+ - `placement`: 'bottom' | 'top' (default 'bottom') - the preferred side; CDK flips it when there is no room.
9
+ Horizontally the bubble starts at the trigger's left edge and opens leftwards when it would cross the right
10
+ edge of the window (a bell in the top-right corner); on a screen too narrow for both it is pushed into view
9
11
  - `open`: model<boolean> (default false) - two-way, so the application can close the bubble from code
12
+ - `maxWidth`: string (default '' = `20rem`) - the panel's maximum width, any CSS length (`'24rem'`). The panel
13
+ is never wider than the window minus the 8 px overlay margin, so wide content wraps instead of spilling out
10
14
 
11
15
  ## Slots
12
16
  - the element carrying the `kptPopoverTrigger` attribute = the trigger; everything else = the panel
@@ -1,5 +1,5 @@
1
1
  import * as _konce_pt_chart from '@konce-pt/chart';
2
- import { KptChartConfig, KptAnimationOptions, KptAlign } from '@konce-pt/chart';
2
+ import { KptChartConfig, KptAnimationOptions, KptAlign, KptDeltaKind } from '@konce-pt/chart';
3
3
  export { KPT_CHART_PALETTE, KptAlign, KptAnimationOptions, KptBarOrientation, KptChartConfig, KptChartSeries, KptChartType, KptFont, KptLegendOptions, KptLegendPosition, KptLegendTitle, KptLineInterpolation, KptPadding, KptPointStyle, KptTitleOptions, KptTooltipContext, KptTooltipOptions, areaPath, barLayout, linePath, niceScale, pieSlices, polarSlices, radarGrid, radarPoints, seriesColor } from '@konce-pt/chart';
4
4
  import * as _angular_core from '@angular/core';
5
5
  import { KptI18n } from '@konce-pt/angular';
@@ -23,6 +23,10 @@ interface KptChartTooltipState {
23
23
  y: number;
24
24
  label: string;
25
25
  rows: KptChartTooltipRow[];
26
+ /** Kierunek ruchu do tego punktu: 1 w prawo, -1 w lewo, 0 bez kierunku - stąd wjeżdża etykieta. */
27
+ dir?: number;
28
+ /** Dymek już był na ekranie i jedzie dalej - etykieta i cyfry animują zmianę (pierwsze pokazanie stoi). */
29
+ live?: boolean;
26
30
  }
27
31
 
28
32
  interface AxisLabel {
@@ -51,6 +55,27 @@ interface LineSeriesVm {
51
55
  area: string | null;
52
56
  points: LinePoint[];
53
57
  }
58
+ /** Odcinek od wartości poprzedniej do bieżącej (duch -> seria). */
59
+ interface DeltaTick {
60
+ x: number;
61
+ y1: number;
62
+ y2: number;
63
+ kind: KptDeltaKind;
64
+ }
65
+ /** Różnica nad punktem - wypływa i gaśnie. */
66
+ interface DeltaChip {
67
+ x: number;
68
+ y: number;
69
+ text: string;
70
+ kind: KptDeltaKind;
71
+ index: number;
72
+ }
73
+ interface LineGhostVm {
74
+ key: string;
75
+ path: string;
76
+ ticks: DeltaTick[];
77
+ chips: DeltaChip[];
78
+ }
54
79
  interface LineVm {
55
80
  plot: {
56
81
  x: number;
@@ -63,9 +88,28 @@ interface LineVm {
63
88
  valueLabels: AxisLabel[];
64
89
  catLabels: AxisLabel[];
65
90
  showPoints: boolean;
91
+ ghost: LineGhostVm[];
92
+ }
93
+ interface BarGhostVm {
94
+ key: string;
95
+ path: string;
96
+ /** Odcinek zmiany: prostokąt od końca słupka-ducha do końca bieżącego. */
97
+ delta: {
98
+ x: number;
99
+ y: number;
100
+ width: number;
101
+ height: number;
102
+ kind: KptDeltaKind;
103
+ };
66
104
  }
67
105
  interface BarVm {
68
106
  orientation: 'vertical' | 'horizontal';
107
+ plot: {
108
+ x: number;
109
+ y: number;
110
+ width: number;
111
+ height: number;
112
+ };
69
113
  bars: {
70
114
  key: string;
71
115
  path: string;
@@ -76,10 +120,12 @@ interface BarVm {
76
120
  tipX: number;
77
121
  tipY: number;
78
122
  index: number;
123
+ cat: number;
79
124
  }[];
80
125
  grid: GridLine[];
81
126
  valueLabels: AxisLabel[];
82
127
  catLabels: AxisLabel[];
128
+ ghost: BarGhostVm[];
83
129
  }
84
130
  interface SliceVm {
85
131
  key: string;
@@ -106,7 +152,12 @@ interface RadarVm {
106
152
  /**
107
153
  * Wykres SVG w pełni konfigurowalny przez obiekt `config`.
108
154
  * Typy: line, bar, pie, doughnut, polarArea, radar. Sygnały + zoneless,
109
- * natywne renderowanie SVG (bez manipulacji DOM). Rdzeń obliczeń: `../core`.
155
+ * natywne renderowanie SVG (bez manipulacji DOM). Rdzeń obliczeń: `@konce-pt/chart`.
156
+ *
157
+ * Ruch: wejście w CSS (rysowanie linii, wzrost słupków); zmiana danych w tym samym wykresie -
158
+ * fala sprężyn od lewej z duchem poprzedniego stanu (`animation.update`, `animation.delta`);
159
+ * dymek jedzie między punktami z cyframi na bębnach (`tooltip.motion`). Systemowe "ogranicz ruch"
160
+ * i `provideKptMotion({ enabled: false })` wyłączają ruch sterowany z kodu.
110
161
  *
111
162
  * @example
112
163
  * <kpt-chart [config]="{ type: 'line', labels: ['Sty','Lut','Mar'],
@@ -119,22 +170,52 @@ declare class KptChart {
119
170
  /** Wysokość viewBoxa (jednostki SVG). */
120
171
  readonly height: _angular_core.InputSignal<number>;
121
172
  protected readonly i18n: KptI18n;
173
+ private readonly motionConfig;
174
+ private readonly uid;
122
175
  /** Id opisu (`config.description`) dla `aria-describedby` wykresu. */
123
176
  protected readonly descId: string;
177
+ /** Id gradientów smugi światła (linia i słupki). */
178
+ protected readonly sheenId: string;
124
179
  /**
125
180
  * Alternatywa tekstowa (WCAG 1.1.1): SVG `role="img"` dostaje nazwę (`ariaLabel` -> tytuł -> i18n),
126
181
  * a dane idą do ukrytej wizualnie tabeli, po której czytnik chodzi komórka po komórce - dymek
127
- * na najechanie jest dostępny tylko myszą.
182
+ * na najechanie jest dostępny tylko myszą. Tabela czyta config, nie klatki ruchu.
128
183
  */
129
184
  protected readonly accessibleName: _angular_core.Signal<string>;
130
185
  protected readonly dataTable: _angular_core.Signal<_konce_pt_chart.KptChartDataTable>;
131
186
  protected readonly hidden: _angular_core.WritableSignal<ReadonlySet<string>>;
132
187
  protected readonly highlighted: _angular_core.WritableSignal<string | null>;
133
- protected readonly tooltip: _angular_core.WritableSignal<KptChartTooltipState | null>;
134
188
  /** Indeks kategorii pod kursorem (dla prowadnicy crosshair w wykresie liniowym). */
135
189
  protected readonly activeIndex: _angular_core.WritableSignal<number | null>;
190
+ private readonly frame;
191
+ private readonly motion;
192
+ private prevConfig;
193
+ private hideTimer;
194
+ private lastTipIndex;
195
+ private readonly tipContent;
196
+ /** Fala z punktu docelowego dymka (wykres liniowy). */
197
+ protected readonly ripple: _angular_core.WritableSignal<{
198
+ id: number;
199
+ x: number;
200
+ y: number;
201
+ color: string;
202
+ }[]>;
203
+ /** Config z wartościami z bieżącej klatki ruchu - z niego liczy się geometria. */
204
+ protected readonly view: _angular_core.Signal<KptChartConfig>;
205
+ protected readonly tooltip: _angular_core.Signal<KptChartTooltipState | null>;
206
+ /**
207
+ * Smuga światła: pasmo gradientu biegnące wzdłuż osi kategorii razem z czołem fali (w poziomych
208
+ * słupkach z góry na dół). Współrzędne końców gradientu w jednostkach viewBoxa.
209
+ */
210
+ protected readonly sheen: _angular_core.Signal<{
211
+ x1: number;
212
+ x2: number;
213
+ y1: number;
214
+ y2: number;
215
+ opacity: number;
216
+ } | null>;
136
217
  protected readonly type: _angular_core.Signal<_konce_pt_chart.KptChartType>;
137
- protected readonly anim: _angular_core.Signal<Required<KptAnimationOptions>>;
218
+ protected readonly anim: _angular_core.Signal<Required<Pick<KptAnimationOptions, "enabled" | "duration" | "delay" | "stagger">>>;
138
219
  protected readonly legendOpts: _angular_core.Signal<{
139
220
  display: boolean;
140
221
  position: _konce_pt_chart.KptLegendPosition;
@@ -146,6 +227,7 @@ declare class KptChart {
146
227
  protected readonly subtitleOpts: _angular_core.Signal<_konce_pt_chart.KptTitleOptions | undefined>;
147
228
  protected readonly titleStyle: _angular_core.Signal<string>;
148
229
  protected readonly subtitleStyle: _angular_core.Signal<string>;
230
+ constructor();
149
231
  protected readonly legendItems: _angular_core.Signal<KptChartLegendItem[]>;
150
232
  protected readonly lineVm: _angular_core.Signal<LineVm | null>;
151
233
  protected readonly barVm: _angular_core.Signal<BarVm | null>;
@@ -163,14 +245,26 @@ declare class KptChart {
163
245
  pillW: number;
164
246
  pillH: number;
165
247
  } | null>;
166
- protected onLineEnter(idx: number, tipX: number, tipY: number, name: string, label: string, value: number, color: string): void;
167
- protected onLineLeave(): void;
248
+ /**
249
+ * Linia i słupki: najbliższa kategoria pod kursorem w całym obszarze wykresu. Dymek ma wiersze
250
+ * wszystkich widocznych serii i jedzie między kategoriami - przerwa między punktami go nie gasi.
251
+ */
252
+ protected onCategoryMove(event: PointerEvent): void;
253
+ /** Wycinki i radar: dymek jednego elementu pod kursorem. */
168
254
  protected showTip(tipX: number, tipY: number, name: string, label: string, value: number, color: string): void;
255
+ /** Ten sam punkt pod kursorem - dymek zostaje (i nie zgaśnie, jeśli właśnie miał). */
256
+ private keepTip;
257
+ private row;
258
+ private openTip;
169
259
  protected hideTip(): void;
170
260
  protected onToggle(key: string): void;
171
261
  protected onHighlight(key: string | null): void;
172
262
  /** Czy dany element ma być wygaszony (aktywne podświetlenie innego). */
173
263
  protected dim(key: string): boolean;
264
+ /** Ruch sterowany z kodu: wyłącza go config, globalne `provideKptMotion` i systemowe "ogranicz ruch". */
265
+ private motionAllowed;
266
+ private tipMotion;
267
+ private onConfig;
174
268
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptChart, never>;
175
269
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptChart, "kpt-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
176
270
  }
@@ -1 +1 @@
1
- {"version":3,"file":"konce-pt-angular-charts.d.ts","sources":["../../charts/src/lib/chart-legend.component.ts","../../charts/src/lib/chart-tooltip.component.ts","../../charts/src/lib/chart.component.ts"],"mappings":";;;;;;UAGiB,kBAAkB;;;;;AAKlC;;UCNgB,kBAAkB;;;;AAIlC;UAEgB,oBAAoB;;;;;;UAM7B,kBAAkB;AACzB;;ACiBD,UAAU,SAAS;;;;AAIjB;AACD;AACD,UAAU,QAAQ;;;;;AAKjB;AACD,UAAU,SAAS;;;;;AAKlB;AACD,UAAU,YAAY;;;;;AAKpB;YACQ,SAAS;AAClB;AACD,UAAU,MAAM;AACd;;;;;;YACQ,YAAY;UACd,QAAQ;iBACD,SAAS;eACX,SAAS;;AAErB;AACD,UAAU,KAAK;AACb;AACA;;;;;;;;;;AAAyI;UACnI,QAAQ;iBACD,SAAS;eACX,SAAS;AACrB;AACD,UAAU,OAAO;;;;;;;;AAQhB;AACD,UAAU,aAAa;;;;;YAKb,SAAS;AAClB;AACD,UAAU,OAAO;;eAEJ,QAAQ;gBACP,SAAS;YACb,aAAa;AACtB;AAKD;;;;;;;;AAQG;AACH,cAea,QAAQ;qBACJ,aAAA,CAAA,WAAA,CAAA,cAAA;;oBAED,aAAA,CAAA,WAAA;;qBAEC,aAAA,CAAA,WAAA;AAEf,6BAAuB,OAAA;;AAEvB;AACA;;;;AAIG;AACH,uCAAiC,aAAA,CAAA,MAAA;AACjC,kCAA4B,aAAA,CAAA,MAAA,CAAA,eAAA,CAAA,iBAAA;AAG5B,+BAAyB,aAAA,CAAA,cAAA,CAAA,WAAA;AACzB,oCAA8B,aAAA,CAAA,cAAA;AAC9B,gCAA0B,aAAA,CAAA,cAAA,CAAA,oBAAA;;AAE1B,oCAA8B,aAAA,CAAA,cAAA;AAG9B,6BAAuB,aAAA,CAAA,MAAA,CAAA,eAAA,CAAA,YAAA;AACvB,6BAAuB,aAAA,CAAA,MAAA,CAAA,QAAA,CAAA,mBAAA;mCAIM,aAAA,CAAA,MAAA;;;;;;AAS1B;AACH,kCAA4B,aAAA,CAAA,MAAA,CAAA,eAAA,CAAA,eAAA;AAC5B,qCAA+B,aAAA,CAAA,MAAA,CAAA,eAAA,CAAA,eAAA;AAE/B,mCAA6B,aAAA,CAAA,MAAA;AAC7B,sCAAgC,aAAA,CAAA,MAAA;AAGhC,oCAA8B,aAAA,CAAA,MAAA,CAAA,kBAAA;AAgB9B,+BAAyB,aAAA,CAAA,MAAA,CAAA,MAAA;AAuCzB,8BAAwB,aAAA,CAAA,MAAA,CAAA,KAAA;AAmDxB,8BAAwB,aAAA,CAAA,MAAA,CAAA,OAAA;AAuBxB,gCAA0B,aAAA,CAAA,MAAA,CAAA,OAAA;kCAmCE,aAAA,CAAA,MAAA;;;;;;;;;;;AAqBzB;AAGH;;;;AAqBA;;;AAYA;oDA7QW,QAAQ;sDAAR,QAAQ;AAiRpB;;;;","names":[]}
1
+ {"version":3,"file":"konce-pt-angular-charts.d.ts","sources":["../../charts/src/lib/chart-legend.component.ts","../../charts/src/lib/chart-tooltip.component.ts","../../charts/src/lib/chart.component.ts"],"mappings":";;;;;;UAGiB,kBAAkB;;;;;AAKlC;;UCLgB,kBAAkB;;;;AAIlC;UAEgB,oBAAoB;;;;;;UAM7B,kBAAkB;;;;;AAKzB;;ACsBD,UAAU,SAAS;;;;AAIjB;AACD;AACD,UAAU,QAAQ;;;;;AAKjB;AACD,UAAU,SAAS;;;;;AAKlB;AACD,UAAU,YAAY;;;;;AAKpB;YACQ,SAAS;AAClB;AACD;AACA,UAAU,SAAS;;;;UAIX,YAAY;AACnB;AACD;AACA,UAAU,SAAS;;;;UAIX,YAAY;;AAEnB;AACD,UAAU,WAAW;;;WAGZ,SAAS;WACT,SAAS;AACjB;AACD,UAAU,MAAM;AACd;;;;;;YACQ,YAAY;UACd,QAAQ;iBACD,SAAS;eACX,SAAS;;WAEb,WAAW;AACnB;AACD,UAAU,UAAU;;;;AAIlB;;;;;cAAoE,YAAY;;AACjF;AACD,UAAU,KAAK;AACb;AACA;;;;;;AACA;;;;;;;;;;;AAAsJ;UAChJ,QAAQ;iBACD,SAAS;eACX,SAAS;WACb,UAAU;AAClB;AACD,UAAU,OAAO;;;;;;;;AAQhB;AACD,UAAU,aAAa;;;;;YAKb,SAAS;AAClB;AACD,UAAU,OAAO;;eAEJ,QAAQ;gBACP,SAAS;YACb,aAAa;AACtB;AAeD;;;;;;;;;;;;;AAaG;AACH,cAea,QAAQ;qBACJ,aAAA,CAAA,WAAA,CAAA,cAAA;;oBAED,aAAA,CAAA,WAAA;;qBAEC,aAAA,CAAA,WAAA;AAEf,6BAAuB,OAAA;AACvB;AACA;;AAEA;;AAEA;AACA;;;;AAIG;AACH,uCAAiC,aAAA,CAAA,MAAA;AACjC,kCAA4B,aAAA,CAAA,MAAA,CAAA,eAAA,CAAA,iBAAA;AAG5B,+BAAyB,aAAA,CAAA,cAAA,CAAA,WAAA;AACzB,oCAA8B,aAAA,CAAA,cAAA;;AAE9B,oCAA8B,aAAA,CAAA,cAAA;AAG9B;AACA;;;;AAIA;;+BAEyB,aAAA,CAAA,cAAA;;;;;AAAqE;;AAG9F,6BAAuB,aAAA,CAAA,MAAA,CAAA,cAAA;AAOvB,gCAA0B,aAAA,CAAA,MAAA,CAAA,oBAAA;AAO1B;;;AAGG;8BACqB,aAAA,CAAA,MAAA;;;;;;AAWrB;AAGH,6BAAuB,aAAA,CAAA,MAAA,CAAA,eAAA,CAAA,YAAA;AACvB,6BAAuB,aAAA,CAAA,MAAA,CAAA,QAAA,CAAA,IAAA,CAAA,mBAAA;mCAIM,aAAA,CAAA,MAAA;;;;;;AAS1B;AACH,kCAA4B,aAAA,CAAA,MAAA,CAAA,eAAA,CAAA,eAAA;AAC5B,qCAA+B,aAAA,CAAA,MAAA,CAAA,eAAA,CAAA,eAAA;AAE/B,mCAA6B,aAAA,CAAA,MAAA;AAC7B,sCAAgC,aAAA,CAAA,MAAA;;AAehC,oCAA8B,aAAA,CAAA,MAAA,CAAA,kBAAA;AAgB9B,+BAAyB,aAAA,CAAA,MAAA,CAAA,MAAA;AAkEzB,8BAAwB,aAAA,CAAA,MAAA,CAAA,KAAA;AAmFxB,8BAAwB,aAAA,CAAA,MAAA,CAAA,OAAA;AAuBxB,gCAA0B,aAAA,CAAA,MAAA,CAAA,OAAA;kCAmCE,aAAA,CAAA,MAAA;;;;;;;;;;;AAuBzB;AAGH;;;AAGG;AACH,oCAAgC,YAAY;;;;AAuC5C;AAMA;AAKA;;AAsBA;;;AAYA;;AAOA;AAKA;AAIA;oDA1cW,QAAQ;sDAAR,QAAQ;AAkepB;;;;","names":[]}
@@ -349,6 +349,7 @@ declare class KptMenu<T = unknown> {
349
349
  protected readonly panelId: string;
350
350
  /** Którą pozycję skupić po otwarciu - strzałka w górę na wyzwalaczu otwiera "od końca". */
351
351
  private focusEdge;
352
+ protected readonly viewportMargin = 8;
352
353
  protected readonly positions: ConnectedPosition[];
353
354
  constructor();
354
355
  protected toggle(): void;
@@ -391,6 +392,7 @@ declare class KptSplitButton<T = unknown> {
391
392
  private readonly panel;
392
393
  /** Którą pozycję skupić po otwarciu - strzałka w górę na przycisku otwiera "od końca". */
393
394
  private focusEdge;
395
+ protected readonly viewportMargin = 8;
394
396
  protected readonly positions: ConnectedPosition[];
395
397
  protected toggle(): void;
396
398
  /** Strzałki na przycisku otwierają menu (albo przenoszą do niego fokus, gdy już jest otwarte). */
@@ -1440,6 +1442,7 @@ declare class KptSelect<T = unknown> implements FormValueControl<unknown>, KptFo
1440
1442
  private readonly injector;
1441
1443
  private readonly typeahead;
1442
1444
  protected readonly panelMinWidth: _angular_core.WritableSignal<number>;
1445
+ protected readonly viewportMargin = 8;
1443
1446
  protected readonly positions: ConnectedPosition[];
1444
1447
  constructor();
1445
1448
  protected optionId(i: number): string;
@@ -1593,11 +1596,12 @@ declare class KptDatepicker implements FormValueControl<string> {
1593
1596
  /** Poziom, na którym klik w komórkę zatwierdza wartość zamiast schodzić niżej. */
1594
1597
  protected readonly commitLevel: _angular_core.Signal<KptCalendarView>;
1595
1598
  protected readonly timeStr: _angular_core.WritableSignal<string>;
1596
- protected readonly dtView: _angular_core.WritableSignal<"calendar" | "clock">;
1599
+ protected readonly dtView: _angular_core.WritableSignal<"clock" | "calendar">;
1597
1600
  private readonly pendingDate;
1598
1601
  /** Tarcza zamiast siatek: tryb 'time' zawsze, 'datetime' po wejściu w pasek czasu. */
1599
1602
  protected readonly showClock: _angular_core.Signal<boolean>;
1600
1603
  protected readonly hasFooter: _angular_core.Signal<boolean>;
1604
+ protected readonly viewportMargin = 8;
1601
1605
  protected readonly positions: ConnectedPosition[];
1602
1606
  constructor();
1603
1607
  /** Dzień i komórka, na które trafi fokus po otwarciu albo zmianie poziomu. */
@@ -1961,7 +1965,7 @@ declare class KptRichText implements FormValueControl<string> {
1961
1965
  y: number;
1962
1966
  }>;
1963
1967
  protected readonly borderOpen: _angular_core.WritableSignal<boolean>;
1964
- protected readonly borderTarget: _angular_core.WritableSignal<"table" | "cell">;
1968
+ protected readonly borderTarget: _angular_core.WritableSignal<"cell" | "table">;
1965
1969
  private ctxCell;
1966
1970
  private resize;
1967
1971
  protected readonly selCount: _angular_core.WritableSignal<number>;
@@ -1978,6 +1982,7 @@ declare class KptRichText implements FormValueControl<string> {
1978
1982
  protected readonly canIndent: _angular_core.WritableSignal<boolean>;
1979
1983
  protected readonly canOutdent: _angular_core.WritableSignal<boolean>;
1980
1984
  protected readonly currentBlock: _angular_core.WritableSignal<string>;
1985
+ protected readonly viewportMargin = 8;
1981
1986
  protected readonly positions: ConnectedPosition[];
1982
1987
  /** Sekcje paska (normalizacja płaskiej listy do jednej grupy). */
1983
1988
  protected readonly sections: _angular_core.Signal<KptRichTool[][]>;
@@ -2505,6 +2510,7 @@ declare class KptDateRange implements FormValueControl<KptDateRangeValue> {
2505
2510
  protected readonly timeEnd: _angular_core.WritableSignal<"start" | "end">;
2506
2511
  private readonly startDate;
2507
2512
  private readonly endDate;
2513
+ protected readonly viewportMargin = 8;
2508
2514
  protected readonly positions: ConnectedPosition[];
2509
2515
  protected readonly panelCount: _angular_core.Signal<number>;
2510
2516
  protected readonly multi: _angular_core.Signal<boolean>;
@@ -3740,7 +3746,7 @@ declare class KptEmpty {
3740
3746
  * Robi z tytułu nagłówek strony (`role="heading"` z `aria-level`), żeby pusty stan pojawił się
3741
3747
  * w strukturze dokumentu - np. gdy zastępuje całą sekcję. Bez tego tytuł to sam tekst.
3742
3748
  */
3743
- readonly headingLevel: _angular_core.InputSignal<2 | 1 | 4 | 3 | 5 | 6 | null>;
3749
+ readonly headingLevel: _angular_core.InputSignal<2 | 1 | 5 | 6 | 4 | 3 | null>;
3744
3750
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptEmpty, never>;
3745
3751
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptEmpty, "kpt-empty", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "headingLevel": { "alias": "headingLevel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
3746
3752
  }
@@ -4082,7 +4088,7 @@ declare class KptDataTable<T = Record<string, unknown>> {
4082
4088
  /** Kolor "stop" i fali w trakcie nasłuchu; domyślnie kolor motywu. */
4083
4089
  readonly filterSpeechColor: _angular_core.InputSignal<KptSpeechColor>;
4084
4090
  /** Pozycja wiersza filtrów kolumn względem etykiet: nad ('top') lub pod ('bottom'). */
4085
- readonly filterRowPosition: _angular_core.InputSignal<"top" | "bottom">;
4091
+ readonly filterRowPosition: _angular_core.InputSignal<"bottom" | "top">;
4086
4092
  /** Rozmiar strony; 0 wyłącza paginację. */
4087
4093
  readonly pageSize: _angular_core.InputSignal<number>;
4088
4094
  readonly pageSizeOptions: _angular_core.InputSignal<readonly number[]>;
@@ -5171,15 +5177,21 @@ declare class KptTooltip {
5171
5177
  */
5172
5178
  declare class KptPopover {
5173
5179
  /** Preferowana strona dymka; gdy brakuje miejsca, CDK przerzuca go na drugą. */
5174
- readonly placement: _angular_core.InputSignal<"top" | "bottom">;
5180
+ readonly placement: _angular_core.InputSignal<"bottom" | "top">;
5175
5181
  /** Nazwa panelu (`role="dialog"`) - okno bez nazwy czytnik ogłasza jako samo "okno dialogowe". */
5176
5182
  readonly ariaLabel: _angular_core.InputSignal<string>;
5183
+ /**
5184
+ * Maksymalna szerokość panelu (dowolna długość CSS, np. `'24rem'`); pusto = `20rem`.
5185
+ * Panel i tak nie wyjdzie poza okno - ogranicza go szerokość okna minus margines nakładek.
5186
+ */
5187
+ readonly maxWidth: _angular_core.InputSignal<string>;
5177
5188
  /** Czy dymek jest otwarty (dwukierunkowe) - aplikacja może go zamknąć z kodu. */
5178
5189
  readonly open: _angular_core.ModelSignal<boolean>;
5179
5190
  private readonly host;
5180
5191
  private readonly injector;
5181
5192
  private readonly panel;
5182
5193
  protected readonly panelId: string;
5194
+ protected readonly viewportMargin = 8;
5183
5195
  protected readonly positions: _angular_core.Signal<ConnectedPosition[]>;
5184
5196
  constructor();
5185
5197
  protected toggle(): void;
@@ -5188,7 +5200,7 @@ declare class KptPopover {
5188
5200
  protected onAttach(): void;
5189
5201
  private control;
5190
5202
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptPopover, never>;
5191
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptPopover, "kpt-popover", never, { "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["[kptPopoverTrigger]", "*"], true, never>;
5203
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptPopover, "kpt-popover", never, { "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["[kptPopoverTrigger]", "*"], true, never>;
5192
5204
  }
5193
5205
 
5194
5206
  /** Z której strony triggera wychodzi karta. */
@@ -5249,6 +5261,7 @@ declare class KptPeek {
5249
5261
  private timer?;
5250
5262
  readonly isOpen: _angular_core.Signal<boolean>;
5251
5263
  readonly pinned: _angular_core.Signal<boolean>;
5264
+ protected readonly viewportMargin = 8;
5252
5265
  protected readonly positions: _angular_core.Signal<ConnectedPosition[]>;
5253
5266
  constructor();
5254
5267
  /** Najazd kursora - na trigger albo na samą kartę. */
@@ -5423,6 +5436,7 @@ declare class KptAutocomplete implements FormValueControl<string> {
5423
5436
  protected readonly field: _konce_pt_angular.KptFieldA11y;
5424
5437
  protected readonly open: _angular_core.WritableSignal<boolean>;
5425
5438
  protected readonly activeIndex: _angular_core.WritableSignal<number>;
5439
+ protected readonly viewportMargin = 8;
5426
5440
  protected readonly positions: ConnectedPosition[];
5427
5441
  protected readonly i18n: KptI18n;
5428
5442
  protected readonly filtered: _angular_core.Signal<readonly string[]>;
@@ -5547,6 +5561,7 @@ declare class KptMenubar<T = unknown> {
5547
5561
  private readonly baseId;
5548
5562
  /** Którą pozycję pod-menu skupić po otwarciu - strzałka w górę otwiera "od końca". */
5549
5563
  private focusEdge;
5564
+ protected readonly viewportMargin = 8;
5550
5565
  protected readonly positions: ConnectedPosition[];
5551
5566
  /**
5552
5567
  * Pozycja z `url` (bez pod-menu, niewyłączona) renderuje się jako `<a href>` - nawigację robi
@@ -5613,6 +5628,7 @@ declare class KptMegamenu<T = unknown> {
5613
5628
  protected readonly panelId: string;
5614
5629
  /** Który odnośnik skupić po otwarciu - strzałka w górę otwiera "od końca". */
5615
5630
  private focusEdge;
5631
+ protected readonly viewportMargin = 8;
5616
5632
  protected readonly positions: ConnectedPosition[];
5617
5633
  /**
5618
5634
  * Pozycja z `url` (bez kolumn, niewyłączona) renderuje się jako `<a href>` - nawigację robi