@pioneer-code/pioneer-charts 22.1.0 → 22.1.3
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/README.md +28 -50
- package/fesm2022/pioneer-code-pioneer-charts.mjs +482 -140
- package/fesm2022/pioneer-code-pioneer-charts.mjs.map +1 -1
- package/package.json +1 -1
- package/scss/bar-chart/bar-horizontal-chart/bar-horizontal-chart.component.scss +0 -12
- package/scss/pioneer-charts.scss +10 -3
- package/scss/plot-line-area-chart/plot-line-area-chart.component.scss +0 -12
- package/themes/pioneer-charts.css +6 -3
- package/themes/pioneer-charts.min.css +1 -1
- package/types/pioneer-code-pioneer-charts.d.ts +206 -38
package/package.json
CHANGED
|
@@ -6,18 +6,6 @@
|
|
|
6
6
|
}
|
|
7
7
|
}
|
|
8
8
|
|
|
9
|
-
.pcac-d3-tooltip {
|
|
10
|
-
position: absolute;
|
|
11
|
-
text-align: center;
|
|
12
|
-
font-size: 14px;
|
|
13
|
-
padding: 0.5rem;
|
|
14
|
-
pointer-events: none;
|
|
15
|
-
display: none;
|
|
16
|
-
background-color: rgba(0,0,0, 0.75);
|
|
17
|
-
color: white;
|
|
18
|
-
border-radius: 5px;
|
|
19
|
-
}
|
|
20
|
-
|
|
21
9
|
// `heightFull` support (see PcacChartConfig.heightFull). The host and the container section are
|
|
22
10
|
// what the chart measures to decide how tall to draw, so both need a height handed down from the
|
|
23
11
|
// consumer's wrapper - otherwise the section is sized by the <svg> inside it and measuring it
|
package/scss/pioneer-charts.scss
CHANGED
|
@@ -5,17 +5,24 @@
|
|
|
5
5
|
@forward "core/theme/imports";
|
|
6
6
|
@use "core/theme/imports";
|
|
7
7
|
|
|
8
|
+
// The tooltip is one body-level element shared by every chart. This class is only the shell that
|
|
9
|
+
// floats it over the page: no visual styling lives here, so a consumer's `<ng-template pcacTooltip>`
|
|
10
|
+
// rendered inside it owns the entire box and nothing of the library's look leaks into it.
|
|
8
11
|
.pcac-d3-tooltip {
|
|
9
12
|
position: absolute;
|
|
13
|
+
pointer-events: none;
|
|
14
|
+
display: none;
|
|
15
|
+
z-index: 1000
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
// The library's own key/value tooltip. Toggled on the shell only while default content is shown.
|
|
19
|
+
.pcac-d3-tooltip-default {
|
|
10
20
|
text-align: center;
|
|
11
21
|
font-size: 14px;
|
|
12
22
|
padding: 0.5rem;
|
|
13
|
-
pointer-events: none;
|
|
14
|
-
display: none;
|
|
15
23
|
background-color: rgba(imports.$gray-800, 0.85);
|
|
16
24
|
color: imports.$white;
|
|
17
25
|
border-radius: 2px;
|
|
18
|
-
z-index: 1000
|
|
19
26
|
}
|
|
20
27
|
|
|
21
28
|
.pcac-grid-rule line {
|
|
@@ -33,18 +33,6 @@
|
|
|
33
33
|
}
|
|
34
34
|
}
|
|
35
35
|
|
|
36
|
-
.pcac-d3-tooltip {
|
|
37
|
-
position: absolute;
|
|
38
|
-
text-align: center;
|
|
39
|
-
font-size: 14px;
|
|
40
|
-
padding: 0.5rem;
|
|
41
|
-
pointer-events: none;
|
|
42
|
-
display: none;
|
|
43
|
-
background-color: rgba(0,0,0, 0.75);
|
|
44
|
-
color: white;
|
|
45
|
-
border-radius: 5px;
|
|
46
|
-
}
|
|
47
|
-
|
|
48
36
|
|
|
49
37
|
// `heightFull` support (see PcacChartConfig.heightFull). The host and the container section are
|
|
50
38
|
// what the chart measures to decide how tall to draw, so both need a height handed down from the
|
|
@@ -1,14 +1,17 @@
|
|
|
1
1
|
.pcac-d3-tooltip {
|
|
2
2
|
position: absolute;
|
|
3
|
+
pointer-events: none;
|
|
4
|
+
display: none;
|
|
5
|
+
z-index: 1000;
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
.pcac-d3-tooltip-default {
|
|
3
9
|
text-align: center;
|
|
4
10
|
font-size: 14px;
|
|
5
11
|
padding: 0.5rem;
|
|
6
|
-
pointer-events: none;
|
|
7
|
-
display: none;
|
|
8
12
|
background-color: rgba(52, 58, 64, 0.85);
|
|
9
13
|
color: #fff;
|
|
10
14
|
border-radius: 2px;
|
|
11
|
-
z-index: 1000;
|
|
12
15
|
}
|
|
13
16
|
|
|
14
17
|
.pcac-grid-rule line {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
.pcac-d3-tooltip{position:absolute;text-align:center;font-size:14px;padding:.5rem;
|
|
1
|
+
.pcac-d3-tooltip{position:absolute;pointer-events:none;display:none;z-index:1000}.pcac-d3-tooltip-default{text-align:center;font-size:14px;padding:.5rem;background-color:rgba(52,58,64,.85);color:#fff;border-radius:2px}.pcac-grid-rule line{stroke:#e9ecef}.pcac-x-axis path,.pcac-x-axis line,.pcac-y-axis path,.pcac-y-axis line{stroke:none}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import * as rxjs from 'rxjs';
|
|
2
2
|
import * as i0 from '@angular/core';
|
|
3
|
-
import {
|
|
3
|
+
import { TemplateRef, ElementRef, Signal } from '@angular/core';
|
|
4
4
|
import { AxisDomain, AxisScale } from 'd3-axis';
|
|
5
5
|
import * as d3_selection from 'd3-selection';
|
|
6
6
|
import { Selection, BaseType } from 'd3-selection';
|
|
@@ -37,6 +37,16 @@ declare class PcacData {
|
|
|
37
37
|
value: string | number | null;
|
|
38
38
|
hide: boolean;
|
|
39
39
|
data: PcacData[];
|
|
40
|
+
/**
|
|
41
|
+
* URL (or data URI) of an image to draw at this point *in place of* its dot. Currently honored
|
|
42
|
+
* by the line/area/plot charts only, on the innermost (point-level) `PcacData`; sized by the
|
|
43
|
+
* chart config's `pointImage` (see `PcacLineAreaChartConfig.pointImage`). Points without one
|
|
44
|
+
* keep their regular dot, so the two can be mixed within a single series.
|
|
45
|
+
*
|
|
46
|
+
* Optional (rather than defaulted) for the same reason as `PcacChartConfig.heightFull`: so
|
|
47
|
+
* existing object-literal / JSON data doesn't have to declare it.
|
|
48
|
+
*/
|
|
49
|
+
image?: string;
|
|
40
50
|
}
|
|
41
51
|
declare enum PcacFormatEnum {
|
|
42
52
|
None = "none",
|
|
@@ -150,15 +160,6 @@ declare class PcacColorService {
|
|
|
150
160
|
static ɵprov: i0.ɵɵInjectableDeclaration<any>;
|
|
151
161
|
}
|
|
152
162
|
|
|
153
|
-
declare class PcacTooltipBuilder {
|
|
154
|
-
tooltip: d3_selection.Selection<HTMLDivElement, unknown, HTMLElement, any>;
|
|
155
|
-
showBarTooltip(event: MouseEvent, data: PcacData, valueFormat?: PcacFormatEnum, keyFormat?: PcacFormatEnum): void;
|
|
156
|
-
hideTooltip(): void;
|
|
157
|
-
private getBarTipData;
|
|
158
|
-
static ɵfac: i0.ɵɵFactoryDeclaration<PcacTooltipBuilder, never>;
|
|
159
|
-
static ɵprov: i0.ɵɵInjectableDeclaration<any>;
|
|
160
|
-
}
|
|
161
|
-
|
|
162
163
|
declare class PcacTransitionService {
|
|
163
164
|
private transitionDuration;
|
|
164
165
|
getTransitionDuration(): number;
|
|
@@ -167,30 +168,107 @@ declare class PcacTransitionService {
|
|
|
167
168
|
}
|
|
168
169
|
|
|
169
170
|
/**
|
|
170
|
-
*
|
|
171
|
+
* Template context handed to a consumer's `<ng-template pcacTooltip>` each time a tooltip is shown.
|
|
172
|
+
*/
|
|
173
|
+
interface PcacTooltipContext {
|
|
174
|
+
/**
|
|
175
|
+
* The hovered datum: a bar, a line/area/plot point, a pie slice, or a threshold. Bound with a
|
|
176
|
+
* bare `let-point` (or any name) in the template.
|
|
177
|
+
*/
|
|
178
|
+
$implicit: PcacData;
|
|
179
|
+
/**
|
|
180
|
+
* The `PcacData` the hovered datum sits inside - the group a bar belongs to, or the series a
|
|
181
|
+
* point belongs to. For a threshold, the data group it's drawn against (a threshold's own
|
|
182
|
+
* `PcacData` usually carries only a value, so this is where its label lives). `null` when there
|
|
183
|
+
* is no enclosing level (pie slices, a chart-wide threshold).
|
|
184
|
+
*/
|
|
185
|
+
parent: PcacData | null;
|
|
186
|
+
/**
|
|
187
|
+
* True when the hovered element is a threshold marker on a bar chart rather than a data point.
|
|
188
|
+
* In that case `$implicit` is the threshold's own `PcacData`.
|
|
189
|
+
*/
|
|
190
|
+
isThreshold: boolean;
|
|
191
|
+
}
|
|
192
|
+
/**
|
|
193
|
+
* Marks an `<ng-template>` projected into any chart component as that chart's tooltip. When
|
|
194
|
+
* present it replaces the default key/value tooltip *entirely* - the library only positions the
|
|
195
|
+
* rendered template; it applies no background, padding or text styling of its own, so the template
|
|
196
|
+
* owns the whole box.
|
|
171
197
|
*
|
|
172
|
-
*
|
|
173
|
-
*
|
|
174
|
-
*
|
|
175
|
-
*
|
|
176
|
-
*
|
|
177
|
-
*
|
|
198
|
+
* ```html
|
|
199
|
+
* <pcac-bar-vertical-chart [config]="config">
|
|
200
|
+
* <ng-template pcacTooltip let-point let-group="parent">
|
|
201
|
+
* <div class="my-tooltip">{{ group?.key }} / {{ point.key }}: {{ point.value | number }}</div>
|
|
202
|
+
* </ng-template>
|
|
203
|
+
* </pcac-bar-vertical-chart>
|
|
204
|
+
* ```
|
|
178
205
|
*
|
|
179
|
-
*
|
|
180
|
-
*
|
|
206
|
+
* The template is rendered with full Angular semantics (pipes, directives, components, DI from
|
|
207
|
+
* the declaring component), so anything a normal template can do works here too.
|
|
181
208
|
*/
|
|
182
|
-
declare class
|
|
209
|
+
declare class PcacTooltipDirective {
|
|
210
|
+
readonly templateRef: TemplateRef<PcacTooltipContext>;
|
|
183
211
|
/**
|
|
184
|
-
*
|
|
185
|
-
*
|
|
186
|
-
* @param rebuild Invoked whenever the chart's container size changes: immediately for the
|
|
187
|
-
* observer's first (guaranteed-initial) callback, debounced for every one after that.
|
|
212
|
+
* Lets the template type-checker know the shape of `let-` variables declared on the
|
|
213
|
+
* `<ng-template>`, so `point.value` etc. are checked against `PcacData` under strictTemplates.
|
|
188
214
|
*/
|
|
189
|
-
|
|
190
|
-
static ɵfac: i0.ɵɵFactoryDeclaration<
|
|
215
|
+
static ngTemplateContextGuard(_dir: PcacTooltipDirective, _ctx: unknown): _ctx is PcacTooltipContext;
|
|
216
|
+
static ɵfac: i0.ɵɵFactoryDeclaration<PcacTooltipDirective, never>;
|
|
217
|
+
static ɵdir: i0.ɵɵDirectiveDeclaration<PcacTooltipDirective, "ng-template[pcacTooltip]", never, {}, {}, never, never, true, never>;
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
declare class PcacTooltipBuilder {
|
|
221
|
+
private appRef;
|
|
222
|
+
/**
|
|
223
|
+
* One tooltip element shared by every chart on the page, appended to `<body>` so it can float
|
|
224
|
+
* over anything. It's only ever a positioning shell: the default look (`.pcac-d3-tooltip-default`)
|
|
225
|
+
* is toggled on when the library renders its own key/value content and off when a consumer's
|
|
226
|
+
* `<ng-template pcacTooltip>` is rendered into it instead, so a custom template owns the whole box.
|
|
227
|
+
*/
|
|
228
|
+
tooltip: d3_selection.Selection<HTMLDivElement, unknown, HTMLElement, any>;
|
|
229
|
+
/**
|
|
230
|
+
* The consumer template currently rendered into the shell, if any. Created on the first show
|
|
231
|
+
* of a hover and torn down in `hideTooltip()` - not kept around between hovers - so a view is
|
|
232
|
+
* never left holding onto a declaring component that has since been destroyed (e.g. after a
|
|
233
|
+
* route change). While it lives, repeated `mousemove`s just update its context in place.
|
|
234
|
+
*/
|
|
235
|
+
private view;
|
|
236
|
+
private viewTemplate;
|
|
237
|
+
/**
|
|
238
|
+
* Shows the tooltip for a hovered datum at the event's position. Renders `template` when the
|
|
239
|
+
* chart has one projected; otherwise falls back to the default key/value content, formatted per
|
|
240
|
+
* `valueFormat`/`keyFormat`.
|
|
241
|
+
*/
|
|
242
|
+
showTooltip(event: MouseEvent, template: TemplateRef<PcacTooltipContext> | undefined, context: PcacTooltipContext, valueFormat?: PcacFormatEnum, keyFormat?: PcacFormatEnum): void;
|
|
243
|
+
/**
|
|
244
|
+
* @deprecated Builders should call `PcacChart.showTooltip()`, which routes through a chart's
|
|
245
|
+
* projected `pcacTooltip` template. This only ever renders the default content.
|
|
246
|
+
*/
|
|
247
|
+
showBarTooltip(event: MouseEvent, data: PcacData, valueFormat?: PcacFormatEnum, keyFormat?: PcacFormatEnum): void;
|
|
248
|
+
hideTooltip(): void;
|
|
249
|
+
private renderDefault;
|
|
250
|
+
private renderTemplate;
|
|
251
|
+
private destroyView;
|
|
252
|
+
/**
|
|
253
|
+
* Centers the (already rendered) tooltip horizontally on the cursor and sits it just above.
|
|
254
|
+
* Measured from the real box rather than fixed offsets so it works for content of any size.
|
|
255
|
+
*/
|
|
256
|
+
private position;
|
|
257
|
+
private getBarTipData;
|
|
258
|
+
static ɵfac: i0.ɵɵFactoryDeclaration<PcacTooltipBuilder, never>;
|
|
191
259
|
static ɵprov: i0.ɵɵInjectableDeclaration<any>;
|
|
192
260
|
}
|
|
193
261
|
|
|
262
|
+
/**
|
|
263
|
+
* Everything `showTooltip()` needs beyond the hovered datum itself. `parent`/`isThreshold` feed
|
|
264
|
+
* the consumer template's context; the formats only apply to the default (no template) content.
|
|
265
|
+
*/
|
|
266
|
+
interface PcacTooltipOptions {
|
|
267
|
+
parent?: PcacData | null;
|
|
268
|
+
isThreshold?: boolean;
|
|
269
|
+
valueFormat?: PcacFormatEnum;
|
|
270
|
+
keyFormat?: PcacFormatEnum;
|
|
271
|
+
}
|
|
194
272
|
interface PcacChartMargin {
|
|
195
273
|
top: number;
|
|
196
274
|
right: number;
|
|
@@ -204,6 +282,7 @@ declare class PcacChart {
|
|
|
204
282
|
tooltipBuilder: PcacTooltipBuilder;
|
|
205
283
|
colorService: PcacColorService;
|
|
206
284
|
margin: PcacChartMargin;
|
|
285
|
+
private readonly defaultMargin;
|
|
207
286
|
svg: Selection<SVGGElement, unknown, BaseType, unknown>;
|
|
208
287
|
width: number;
|
|
209
288
|
height: number;
|
|
@@ -225,6 +304,29 @@ declare class PcacChart {
|
|
|
225
304
|
*/
|
|
226
305
|
private lastContainerHeight;
|
|
227
306
|
private lastHeightFull;
|
|
307
|
+
/**
|
|
308
|
+
* Resolves the consumer's projected `<ng-template pcacTooltip>`, if any. Each chart component
|
|
309
|
+
* points this at its own `contentChild(PcacTooltipDirective)` query. It's a getter rather than
|
|
310
|
+
* a captured value so it's read lazily, at hover time, from inside a D3 listener: reading the
|
|
311
|
+
* query signal in the component's build effect instead would make the effect depend on it and
|
|
312
|
+
* rebuild the whole chart (restarting its entry animation) whenever the query resolves.
|
|
313
|
+
*/
|
|
314
|
+
tooltipTemplate: () => TemplateRef<PcacTooltipContext> | undefined;
|
|
315
|
+
/**
|
|
316
|
+
* Puts `margin` back to its defaults. Builders must call this at the top of `buildChart()`,
|
|
317
|
+
* before any per-build adjustment (`hideAxis` zeroing sides, label widths measured into
|
|
318
|
+
* `margin.left`): `margin` lives on this per-chart instance and so persists between builds,
|
|
319
|
+
* and without a reset an adjustment made for one config silently carries into the next -
|
|
320
|
+
* e.g. axes drawn with no room after `hideAxis` flips back to false.
|
|
321
|
+
*/
|
|
322
|
+
resetMargin(): void;
|
|
323
|
+
/**
|
|
324
|
+
* Shows the tooltip for a hovered datum, through the chart's `pcacTooltip` template when one is
|
|
325
|
+
* projected and the default key/value content otherwise. Every builder's hover handler should
|
|
326
|
+
* go through here rather than `tooltipBuilder` directly so the template is honored everywhere.
|
|
327
|
+
*/
|
|
328
|
+
showTooltip(event: MouseEvent, data: PcacData, options?: PcacTooltipOptions): void;
|
|
329
|
+
hideTooltip(): void;
|
|
228
330
|
/**
|
|
229
331
|
* Prior to building a chart, we need to initialize the state of the chart.
|
|
230
332
|
*
|
|
@@ -298,7 +400,6 @@ declare class BarHorizontalChartBuilder extends PcacChart {
|
|
|
298
400
|
private yScaleGrouped;
|
|
299
401
|
private barClickedSource;
|
|
300
402
|
private config;
|
|
301
|
-
private cachedMargins;
|
|
302
403
|
barClicked$: rxjs.Observable<PcacData>;
|
|
303
404
|
buildChart(chartElm: ElementRef, config: PcacBarHorizontalChartConfig): void;
|
|
304
405
|
private adjustForHiddenAxis;
|
|
@@ -319,10 +420,15 @@ declare class PcacBarHorizontalChartComponent {
|
|
|
319
420
|
readonly config: i0.InputSignal<PcacBarHorizontalChartConfig>;
|
|
320
421
|
readonly chartElm: i0.Signal<ElementRef<any>>;
|
|
321
422
|
readonly barClicked: i0.OutputRef<_pioneer_code_pioneer_charts.PcacData>;
|
|
423
|
+
/**
|
|
424
|
+
* Optional consumer `<ng-template pcacTooltip>` projected into this element; replaces the
|
|
425
|
+
* default tooltip when present (see PcacTooltipDirective).
|
|
426
|
+
*/
|
|
427
|
+
readonly tooltipTemplate: i0.Signal<PcacTooltipDirective | undefined>;
|
|
322
428
|
constructor();
|
|
323
429
|
buildChart(): void;
|
|
324
430
|
static ɵfac: i0.ɵɵFactoryDeclaration<PcacBarHorizontalChartComponent, never>;
|
|
325
|
-
static ɵcmp: i0.ɵɵComponentDeclaration<PcacBarHorizontalChartComponent, "pcac-bar-horizontal-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "barClicked": "barClicked"; },
|
|
431
|
+
static ɵcmp: i0.ɵɵComponentDeclaration<PcacBarHorizontalChartComponent, "pcac-bar-horizontal-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "barClicked": "barClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
326
432
|
}
|
|
327
433
|
|
|
328
434
|
declare class PcacBarVerticalChartConfig extends PcacChartConfig {
|
|
@@ -340,9 +446,6 @@ declare class PcacBarVerticalChartColorOverrideConfig {
|
|
|
340
446
|
colors: string[];
|
|
341
447
|
}
|
|
342
448
|
|
|
343
|
-
interface IBarVerticalChartBuilder {
|
|
344
|
-
buildChart(chartElm: ElementRef, config: PcacBarVerticalChartConfig): void;
|
|
345
|
-
}
|
|
346
449
|
/**
|
|
347
450
|
* Provided per-component (see PcacBarVerticalChartComponent's `providers`), not root-scoped:
|
|
348
451
|
* this builder extends PcacChart, which holds mutable per-chart-instance state (margin, width,
|
|
@@ -375,10 +478,40 @@ declare class PcacBarVerticalChartComponent {
|
|
|
375
478
|
readonly config: i0.InputSignal<PcacBarVerticalChartConfig>;
|
|
376
479
|
readonly chartElm: i0.Signal<ElementRef<any>>;
|
|
377
480
|
readonly barClicked: i0.OutputRef<_pioneer_code_pioneer_charts.PcacData>;
|
|
481
|
+
/**
|
|
482
|
+
* Optional consumer `<ng-template pcacTooltip>` projected into this element; replaces the
|
|
483
|
+
* default tooltip when present (see PcacTooltipDirective).
|
|
484
|
+
*/
|
|
485
|
+
readonly tooltipTemplate: i0.Signal<PcacTooltipDirective | undefined>;
|
|
378
486
|
constructor();
|
|
379
487
|
buildChart(): void;
|
|
380
488
|
static ɵfac: i0.ɵɵFactoryDeclaration<PcacBarVerticalChartComponent, never>;
|
|
381
|
-
static ɵcmp: i0.ɵɵComponentDeclaration<PcacBarVerticalChartComponent, "pcac-bar-vertical-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "barClicked": "barClicked"; },
|
|
489
|
+
static ɵcmp: i0.ɵɵComponentDeclaration<PcacBarVerticalChartComponent, "pcac-bar-vertical-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "barClicked": "barClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
490
|
+
}
|
|
491
|
+
|
|
492
|
+
/**
|
|
493
|
+
* Rebuilds a chart whenever its container's real, laid-out size changes.
|
|
494
|
+
*
|
|
495
|
+
* A plain `window:resize` listener (the previous approach) misses any layout-driven size change
|
|
496
|
+
* that isn't a viewport resize — a sidebar collapsing, a tab becoming active, a flex/grid reflow.
|
|
497
|
+
* It also can't help a chart that mounts already holding data (e.g. behind a loading gate): that
|
|
498
|
+
* chart's first `ngOnChanges` can fire before the browser has committed layout for its own
|
|
499
|
+
* just-created DOM node, so `PcacChart.initializeChartState()` measures a 0-width container and
|
|
500
|
+
* bails out with nothing drawn — and with no resize ever firing, nothing retries it.
|
|
501
|
+
*
|
|
502
|
+
* `ResizeObserver`'s callback contract guarantees real, laid-out dimensions on every firing,
|
|
503
|
+
* including its first, so observing the container naturally retries that exact case.
|
|
504
|
+
*/
|
|
505
|
+
declare class PcacChartResizeService {
|
|
506
|
+
/**
|
|
507
|
+
* Call once from a chart component's constructor (an injection context).
|
|
508
|
+
* @param chartElm Signal resolving to the chart's `<svg>` element ref, e.g. a `viewChild.required` query.
|
|
509
|
+
* @param rebuild Invoked whenever the chart's container size changes: immediately for the
|
|
510
|
+
* observer's first (guaranteed-initial) callback, debounced for every one after that.
|
|
511
|
+
*/
|
|
512
|
+
observe(chartElm: Signal<ElementRef>, rebuild: () => void): void;
|
|
513
|
+
static ɵfac: i0.ɵɵFactoryDeclaration<PcacChartResizeService, never>;
|
|
514
|
+
static ɵprov: i0.ɵɵInjectableDeclaration<any>;
|
|
382
515
|
}
|
|
383
516
|
|
|
384
517
|
declare class PcacLegendConfigItem {
|
|
@@ -405,6 +538,15 @@ declare enum PcacLineAreaPlotChartConfigType {
|
|
|
405
538
|
Area = "area",
|
|
406
539
|
Plot = "plot"
|
|
407
540
|
}
|
|
541
|
+
/**
|
|
542
|
+
* Sizing for the images drawn in place of a point's dot (see `PcacData.image`). An image is
|
|
543
|
+
* scaled uniformly (up or down) to fit inside a `maxWidth` x `maxHeight` box, preserving its
|
|
544
|
+
* aspect ratio, and is centered on the data point exactly where the dot would have been.
|
|
545
|
+
*/
|
|
546
|
+
declare class PcacPointImageConfig {
|
|
547
|
+
maxWidth: number;
|
|
548
|
+
maxHeight: number;
|
|
549
|
+
}
|
|
408
550
|
declare class PcacLineAreaChartConfig extends PcacChartConfig {
|
|
409
551
|
enableEffects: boolean;
|
|
410
552
|
enableZoom: boolean;
|
|
@@ -421,6 +563,12 @@ declare class PcacLineAreaChartConfig extends PcacChartConfig {
|
|
|
421
563
|
* Hex color codes to override the default colors
|
|
422
564
|
*/
|
|
423
565
|
colorOverride: string[];
|
|
566
|
+
/**
|
|
567
|
+
* Bounding box for any point images (`PcacData.image`) on this chart. Optional; each field falls
|
|
568
|
+
* back to the `PcacPointImageConfig` default when not given, so a consumer only setting `image`
|
|
569
|
+
* on their data still gets a sensibly-sized result.
|
|
570
|
+
*/
|
|
571
|
+
pointImage?: Partial<PcacPointImageConfig>;
|
|
424
572
|
}
|
|
425
573
|
|
|
426
574
|
declare class PcacPlotChartConfig extends PcacLineAreaChartConfig {
|
|
@@ -430,8 +578,13 @@ declare class PcacPlotChart {
|
|
|
430
578
|
readonly config: i0.InputSignal<PcacPlotChartConfig>;
|
|
431
579
|
readonly types: typeof PcacLineAreaPlotChartConfigType;
|
|
432
580
|
readonly dotClicked: i0.OutputEmitterRef<PcacData>;
|
|
581
|
+
/**
|
|
582
|
+
* Optional consumer `<ng-template pcacTooltip>` projected into this element, forwarded to the
|
|
583
|
+
* inner chart (see PcacLineAreaChartComponent.tooltipTemplate for why it can't query it itself).
|
|
584
|
+
*/
|
|
585
|
+
readonly tooltipTemplate: i0.Signal<PcacTooltipDirective | undefined>;
|
|
433
586
|
static ɵfac: i0.ɵɵFactoryDeclaration<PcacPlotChart, never>;
|
|
434
|
-
static ɵcmp: i0.ɵɵComponentDeclaration<PcacPlotChart, "pcac-plot-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "dotClicked": "dotClicked"; },
|
|
587
|
+
static ɵcmp: i0.ɵɵComponentDeclaration<PcacPlotChart, "pcac-plot-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "dotClicked": "dotClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
435
588
|
}
|
|
436
589
|
|
|
437
590
|
declare class PcacLineChartConfig extends PcacLineAreaChartConfig {
|
|
@@ -441,8 +594,13 @@ declare class PcacLineChart {
|
|
|
441
594
|
readonly config: i0.InputSignal<PcacLineChartConfig>;
|
|
442
595
|
readonly types: typeof PcacLineAreaPlotChartConfigType;
|
|
443
596
|
readonly dotClicked: i0.OutputEmitterRef<PcacData>;
|
|
597
|
+
/**
|
|
598
|
+
* Optional consumer `<ng-template pcacTooltip>` projected into this element, forwarded to the
|
|
599
|
+
* inner chart (see PcacLineAreaChartComponent.tooltipTemplate for why it can't query it itself).
|
|
600
|
+
*/
|
|
601
|
+
readonly tooltipTemplate: i0.Signal<PcacTooltipDirective | undefined>;
|
|
444
602
|
static ɵfac: i0.ɵɵFactoryDeclaration<PcacLineChart, never>;
|
|
445
|
-
static ɵcmp: i0.ɵɵComponentDeclaration<PcacLineChart, "pcac-line-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "dotClicked": "dotClicked"; },
|
|
603
|
+
static ɵcmp: i0.ɵɵComponentDeclaration<PcacLineChart, "pcac-line-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "dotClicked": "dotClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
446
604
|
}
|
|
447
605
|
|
|
448
606
|
declare class PcacAreaChartConfig extends PcacLineAreaChartConfig {
|
|
@@ -452,8 +610,13 @@ declare class PcacAreaChart {
|
|
|
452
610
|
readonly config: i0.InputSignal<PcacAreaChartConfig>;
|
|
453
611
|
readonly types: typeof PcacLineAreaPlotChartConfigType;
|
|
454
612
|
readonly dotClicked: i0.OutputEmitterRef<PcacData>;
|
|
613
|
+
/**
|
|
614
|
+
* Optional consumer `<ng-template pcacTooltip>` projected into this element, forwarded to the
|
|
615
|
+
* inner chart (see PcacLineAreaChartComponent.tooltipTemplate for why it can't query it itself).
|
|
616
|
+
*/
|
|
617
|
+
readonly tooltipTemplate: i0.Signal<PcacTooltipDirective | undefined>;
|
|
455
618
|
static ɵfac: i0.ɵɵFactoryDeclaration<PcacAreaChart, never>;
|
|
456
|
-
static ɵcmp: i0.ɵɵComponentDeclaration<PcacAreaChart, "pcac-area-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "dotClicked": "dotClicked"; },
|
|
619
|
+
static ɵcmp: i0.ɵɵComponentDeclaration<PcacAreaChart, "pcac-area-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "dotClicked": "dotClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
457
620
|
}
|
|
458
621
|
|
|
459
622
|
declare class PcacPieChartConfig extends PcacChartConfig {
|
|
@@ -486,11 +649,16 @@ declare class PcacPieChartComponent {
|
|
|
486
649
|
readonly config: i0.InputSignal<PcacPieChartConfig>;
|
|
487
650
|
readonly chartElm: i0.Signal<ElementRef<any>>;
|
|
488
651
|
readonly sliceClicked: i0.OutputRef<_pioneer_code_pioneer_charts.PcacData>;
|
|
652
|
+
/**
|
|
653
|
+
* Optional consumer `<ng-template pcacTooltip>` projected into this element; replaces the
|
|
654
|
+
* default tooltip when present (see PcacTooltipDirective).
|
|
655
|
+
*/
|
|
656
|
+
readonly tooltipTemplate: i0.Signal<PcacTooltipDirective | undefined>;
|
|
489
657
|
constructor();
|
|
490
658
|
buildChart(): void;
|
|
491
659
|
static ɵfac: i0.ɵɵFactoryDeclaration<PcacPieChartComponent, never>;
|
|
492
|
-
static ɵcmp: i0.ɵɵComponentDeclaration<PcacPieChartComponent, "pcac-pie-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "sliceClicked": "sliceClicked"; },
|
|
660
|
+
static ɵcmp: i0.ɵɵComponentDeclaration<PcacPieChartComponent, "pcac-pie-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "sliceClicked": "sliceClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
493
661
|
}
|
|
494
662
|
|
|
495
|
-
export { BarHorizontalChartBuilder, BarVerticalChartBuilder, PcacAreaChart, PcacAreaChartConfig, PcacAxisBuilder, PcacBarHorizontalChartColorOverrideConfig, PcacBarHorizontalChartComponent, PcacBarHorizontalChartConfig, PcacBarVerticalChartColorOverrideConfig, PcacBarVerticalChartComponent, PcacBarVerticalChartConfig, PcacChart, PcacChartConfig, PcacChartResizeService, PcacColorService, PcacData, PcacFormatEnum, PcacGridBuilder, PcacLegend, PcacLegendConfig, PcacLegendConfigItem, PcacLineChart, PcacLineChartConfig, PcacPieChartComponent, PcacPieChartConfig, PcacPlotChart, PcacPlotChartConfig, PcacTooltipBuilder, PcacTransitionService, PieChartBuilder };
|
|
496
|
-
export type {
|
|
663
|
+
export { BarHorizontalChartBuilder, BarVerticalChartBuilder, PcacAreaChart, PcacAreaChartConfig, PcacAxisBuilder, PcacBarHorizontalChartColorOverrideConfig, PcacBarHorizontalChartComponent, PcacBarHorizontalChartConfig, PcacBarVerticalChartColorOverrideConfig, PcacBarVerticalChartComponent, PcacBarVerticalChartConfig, PcacChart, PcacChartConfig, PcacChartResizeService, PcacColorService, PcacData, PcacFormatEnum, PcacGridBuilder, PcacLegend, PcacLegendConfig, PcacLegendConfigItem, PcacLineChart, PcacLineChartConfig, PcacPieChartComponent, PcacPieChartConfig, PcacPlotChart, PcacPlotChartConfig, PcacPointImageConfig, PcacTooltipBuilder, PcacTooltipDirective, PcacTransitionService, PieChartBuilder };
|
|
664
|
+
export type { IPcacAxisBuilderConfig, IPcacGridBuilderConfig, PcacChartMargin, PcacTooltipContext, PcacTooltipOptions };
|