@pioneer-code/pioneer-charts 22.2.17 → 22.2.19
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/fesm2022/pioneer-code-pioneer-charts.mjs +1401 -354
- package/fesm2022/pioneer-code-pioneer-charts.mjs.map +1 -1
- package/package.json +5 -3
- package/scss/dot-plot-chart/dot-plot-chart.component.scss +27 -0
- package/scss/legend/legend.component.scss +6 -0
- package/scss/pioneer-charts.scss +4 -2
- package/scss/plot-line-area-chart/plot-line-area-chart.component.scss +37 -2
- package/scss/proximity-chart/proximity-chart.component.scss +68 -0
- package/themes/pioneer-charts.css +2 -2
- package/themes/pioneer-charts.min.css +1 -1
- package/types/pioneer-code-pioneer-charts.d.ts +281 -51
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import * as _pioneer_code_pioneer_charts from '@pioneer-code/pioneer-charts';
|
|
2
2
|
import * as _angular_core from '@angular/core';
|
|
3
|
-
import { TemplateRef
|
|
3
|
+
import { TemplateRef } from '@angular/core';
|
|
4
4
|
|
|
5
5
|
/**
|
|
6
6
|
* Base configuration for all charts.
|
|
@@ -90,8 +90,8 @@ declare class PcacAxisConfig {
|
|
|
90
90
|
* the axis. Labels follow the marks (D3 places them at tick length + 3px), and the chart's
|
|
91
91
|
* margins grow or shrink by the same amount so the plot area makes room for them - a longer
|
|
92
92
|
* tick means a slightly smaller plot, never labels pushed off the edge. Only the per-tick marks
|
|
93
|
-
* change; the axis line's two end-caps keep their default length.
|
|
94
|
-
*
|
|
93
|
+
* change; the axis line's two end-caps keep their default length. Colored by `tickColor`, the
|
|
94
|
+
* theme's `$gray-900` (like the axis line) by default.
|
|
95
95
|
*/
|
|
96
96
|
tickSize?: number;
|
|
97
97
|
/**
|
|
@@ -106,8 +106,8 @@ declare class PcacAxisConfig {
|
|
|
106
106
|
tickLabelColor?: string;
|
|
107
107
|
/**
|
|
108
108
|
* Draw a solid line along the axis itself (the full length of the axis, with D3's short
|
|
109
|
-
* end-caps). Off by default, as the theme has always hidden it.
|
|
110
|
-
*
|
|
109
|
+
* end-caps). Off by default, as the theme has always hidden it. Colored by `lineColor`, the
|
|
110
|
+
* theme's `$gray-900` by default.
|
|
111
111
|
*/
|
|
112
112
|
showLine?: boolean;
|
|
113
113
|
/**
|
|
@@ -140,7 +140,8 @@ declare class PcacAxisConfig {
|
|
|
140
140
|
* (`yAxis`) or key (`xAxis`) in the default tooltip. On the line/area/plot charts the x axis's
|
|
141
141
|
* format is also what decides how a point's `key` maps to an x position (by index for the
|
|
142
142
|
* default, `Decimal` and `DateTime` by the key's own value on a linear/time scale - see
|
|
143
|
-
* `PcacLineAreaChartConfig`); a bar chart's category axis
|
|
143
|
+
* `PcacLineAreaChartConfig`); on a bar chart's category axis it only formats keys that are
|
|
144
|
+
* numbers, and shows any other key as it is. Default `None`, which
|
|
144
145
|
* on those charts behaves as `DatasetLength`.
|
|
145
146
|
*/
|
|
146
147
|
format?: PcacFormatEnum;
|
|
@@ -193,6 +194,17 @@ declare class PcacData {
|
|
|
193
194
|
* Optional for the same reason as `image`.
|
|
194
195
|
*/
|
|
195
196
|
range?: PcacDataRange;
|
|
197
|
+
/**
|
|
198
|
+
* A third number for this point, shown as how full a ring around its mark is - on a scatter of
|
|
199
|
+
* two measures, say, a third one per point. Out of the chart config's `pointGauge.max`: at `max`
|
|
200
|
+
* or above the ring is full, at `0` or below it's empty. Currently honored by the line/area/plot
|
|
201
|
+
* charts only, on the innermost (point-level) `PcacData`, and only drawn when the chart config
|
|
202
|
+
* turns `pointGauge` on (see `PcacPointGaugeConfig`). A point without one gets no ring at all,
|
|
203
|
+
* which can itself say something ("doesn't apply").
|
|
204
|
+
*
|
|
205
|
+
* Optional for the same reason as `image`.
|
|
206
|
+
*/
|
|
207
|
+
gauge?: number;
|
|
196
208
|
}
|
|
197
209
|
/**
|
|
198
210
|
* One side of a `PcacDataRange`. `min` above `max` is read as the other way round; `min` equal to
|
|
@@ -233,10 +245,10 @@ declare class PcacBarHorizontalChartConfig extends PcacAxisChartConfig {
|
|
|
233
245
|
spreadColorsPerGroup: boolean;
|
|
234
246
|
/**
|
|
235
247
|
* Bar colors, any CSS color, in place of the theme palette - by series, or by group with
|
|
236
|
-
* `spreadColorsPerGroup`. Repeated when there are more series (or groups) than colors.
|
|
237
|
-
* the theme palette is used.
|
|
248
|
+
* `spreadColorsPerGroup`. Repeated when there are more series (or groups) than colors. Omitted
|
|
249
|
+
* or empty, the theme palette is used - optional, as on every chart's config.
|
|
238
250
|
*/
|
|
239
|
-
colorOverride
|
|
251
|
+
colorOverride?: string[];
|
|
240
252
|
}
|
|
241
253
|
|
|
242
254
|
/**
|
|
@@ -343,10 +355,10 @@ declare class PcacTooltipDirective {
|
|
|
343
355
|
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PcacTooltipDirective, "ng-template[pcacTooltip]", never, {}, {}, never, never, true, never>;
|
|
344
356
|
}
|
|
345
357
|
|
|
346
|
-
declare class
|
|
358
|
+
declare class PcacBarHorizontalChart {
|
|
347
359
|
private chartBuilder;
|
|
348
360
|
readonly config: _angular_core.InputSignal<PcacBarHorizontalChartConfig>;
|
|
349
|
-
readonly chartElm
|
|
361
|
+
private readonly chartElm;
|
|
350
362
|
readonly barClicked: _angular_core.OutputRef<_pioneer_code_pioneer_charts.PcacData>;
|
|
351
363
|
/**
|
|
352
364
|
* Optional consumer `<ng-template pcacTooltip>` projected into this element; replaces the
|
|
@@ -354,9 +366,9 @@ declare class PcacBarHorizontalChartComponent {
|
|
|
354
366
|
*/
|
|
355
367
|
readonly tooltipTemplate: _angular_core.Signal<PcacTooltipDirective | undefined>;
|
|
356
368
|
constructor();
|
|
357
|
-
buildChart
|
|
358
|
-
static ɵfac: _angular_core.ɵɵFactoryDeclaration<
|
|
359
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<
|
|
369
|
+
private buildChart;
|
|
370
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<PcacBarHorizontalChart, never>;
|
|
371
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<PcacBarHorizontalChart, "pcac-bar-horizontal-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "barClicked": "barClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
360
372
|
}
|
|
361
373
|
|
|
362
374
|
declare class PcacBarVerticalChartConfig extends PcacAxisChartConfig {
|
|
@@ -365,16 +377,16 @@ declare class PcacBarVerticalChartConfig extends PcacAxisChartConfig {
|
|
|
365
377
|
spreadColorsPerGroup: boolean;
|
|
366
378
|
/**
|
|
367
379
|
* Bar colors, any CSS color, in place of the theme palette - by series, or by group with
|
|
368
|
-
* `spreadColorsPerGroup`. Repeated when there are more series (or groups) than colors.
|
|
369
|
-
* the theme palette is used.
|
|
380
|
+
* `spreadColorsPerGroup`. Repeated when there are more series (or groups) than colors. Omitted
|
|
381
|
+
* or empty, the theme palette is used - optional, as on every chart's config.
|
|
370
382
|
*/
|
|
371
|
-
colorOverride
|
|
383
|
+
colorOverride?: string[];
|
|
372
384
|
}
|
|
373
385
|
|
|
374
|
-
declare class
|
|
386
|
+
declare class PcacBarVerticalChart {
|
|
375
387
|
private chartBuilder;
|
|
376
388
|
readonly config: _angular_core.InputSignal<PcacBarVerticalChartConfig>;
|
|
377
|
-
readonly chartElm
|
|
389
|
+
private readonly chartElm;
|
|
378
390
|
readonly barClicked: _angular_core.OutputRef<_pioneer_code_pioneer_charts.PcacData>;
|
|
379
391
|
/**
|
|
380
392
|
* Optional consumer `<ng-template pcacTooltip>` projected into this element; replaces the
|
|
@@ -382,9 +394,9 @@ declare class PcacBarVerticalChartComponent {
|
|
|
382
394
|
*/
|
|
383
395
|
readonly tooltipTemplate: _angular_core.Signal<PcacTooltipDirective | undefined>;
|
|
384
396
|
constructor();
|
|
385
|
-
buildChart
|
|
386
|
-
static ɵfac: _angular_core.ɵɵFactoryDeclaration<
|
|
387
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<
|
|
397
|
+
private buildChart;
|
|
398
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<PcacBarVerticalChart, never>;
|
|
399
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<PcacBarVerticalChart, "pcac-bar-vertical-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "barClicked": "barClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
388
400
|
}
|
|
389
401
|
|
|
390
402
|
declare class PcacColorService {
|
|
@@ -440,26 +452,6 @@ declare class PcacColorService {
|
|
|
440
452
|
static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
|
|
441
453
|
}
|
|
442
454
|
|
|
443
|
-
declare class PcacLegendConfigItem {
|
|
444
|
-
label: string;
|
|
445
|
-
checked: boolean;
|
|
446
|
-
colorOverride: string | null;
|
|
447
|
-
}
|
|
448
|
-
declare class PcacLegendConfig {
|
|
449
|
-
heading: string | null;
|
|
450
|
-
items: PcacLegendConfigItem[];
|
|
451
|
-
}
|
|
452
|
-
declare class PcacLegend {
|
|
453
|
-
readonly headingId: string;
|
|
454
|
-
readonly colorService: PcacColorService;
|
|
455
|
-
config: _angular_core.ModelSignal<PcacLegendConfig>;
|
|
456
|
-
itemClicked: _angular_core.OutputEmitterRef<PcacLegendConfigItem[]>;
|
|
457
|
-
colorScale: _angular_core.Signal<string[]>;
|
|
458
|
-
onItemClicked(index: number): void;
|
|
459
|
-
static ɵfac: _angular_core.ɵɵFactoryDeclaration<PcacLegend, never>;
|
|
460
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<PcacLegend, "pcac-legend", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "config": "configChange"; "itemClicked": "itemClicked"; }, never, never, true, never>;
|
|
461
|
-
}
|
|
462
|
-
|
|
463
455
|
declare enum PcacLineAreaPlotChartConfigType {
|
|
464
456
|
Line = "line",
|
|
465
457
|
Area = "area",
|
|
@@ -513,6 +505,80 @@ declare class PcacPointRangeConfig {
|
|
|
513
505
|
*/
|
|
514
506
|
color?: string;
|
|
515
507
|
}
|
|
508
|
+
/**
|
|
509
|
+
* Drawing for `PcacData.gauge` on the line/area/plot charts: a ring around each point's mark (its
|
|
510
|
+
* dot, or its image) whose arc fills clockwise from 12 o'clock in proportion to `gauge / max`,
|
|
511
|
+
* over a faint full-circle track. Drawn with the mark, so it moves with zoom and fan-out; fan-out
|
|
512
|
+
* spacing and the chart's edge space grow to fit it. Points without a `gauge` get no ring.
|
|
513
|
+
*/
|
|
514
|
+
declare class PcacPointGaugeConfig {
|
|
515
|
+
/** The `gauge` value of a full ring. Default 1, for values that are already a fraction. */
|
|
516
|
+
max: number;
|
|
517
|
+
/** Ring thickness in px. */
|
|
518
|
+
width: number;
|
|
519
|
+
/** Space between the mark (the image box, or a hovered dot) and the ring, in px. */
|
|
520
|
+
gap: number;
|
|
521
|
+
/** Draw the unfilled rest of the ring, so an arc reads as a share of a whole. */
|
|
522
|
+
showTrack: boolean;
|
|
523
|
+
/**
|
|
524
|
+
* What the gauge measures, e.g. `'PSA'`. When set, each point's screen reader name ends with it
|
|
525
|
+
* and the point's value - "…, PSA 0.018" - since the ring itself is only visual. Unset, the
|
|
526
|
+
* ring isn't read at all; say what it means in the chart's `ariaLabel`, or a custom tooltip.
|
|
527
|
+
*/
|
|
528
|
+
name?: string;
|
|
529
|
+
/**
|
|
530
|
+
* Any CSS color for the filled arc. Unset, each takes its series' color. Applied as
|
|
531
|
+
* `--pcac-point-gauge-color` on the chart's `.dots` groups, so a stylesheet can set it on an
|
|
532
|
+
* ancestor instead (a config value wins).
|
|
533
|
+
*/
|
|
534
|
+
color?: string;
|
|
535
|
+
/** Any CSS color for the track (`--pcac-point-gauge-track-color`). Theme default `$gray-200`. */
|
|
536
|
+
trackColor?: string;
|
|
537
|
+
}
|
|
538
|
+
/**
|
|
539
|
+
* A line across the plot at one value on an axis (see `PcacLineAreaChartConfig.referenceLines`):
|
|
540
|
+
* a target, a threshold, a median. Drawn dashed, over the grid and under the series, clipped to
|
|
541
|
+
* the plot area, and moved with zoom like the data.
|
|
542
|
+
*/
|
|
543
|
+
declare class PcacReferenceLine {
|
|
544
|
+
/** Which axis `value` is on: `'y'` draws a horizontal line, `'x'` a vertical one. */
|
|
545
|
+
axis: 'x' | 'y';
|
|
546
|
+
/**
|
|
547
|
+
* Where the line sits, in the axis's own terms: a number on the y axis; on the x axis, whatever
|
|
548
|
+
* a point's `key` would be under `xAxis.format` - a number for `Decimal`, a date (or anything
|
|
549
|
+
* `new Date()` reads) for `DateTime`, a series index otherwise.
|
|
550
|
+
*/
|
|
551
|
+
value: number | string;
|
|
552
|
+
/**
|
|
553
|
+
* A few words drawn at the line's far end, inside the plot: above the right end of a horizontal
|
|
554
|
+
* line, beside the top of a vertical one. Styled by the theme's `.reference-line-label` rule.
|
|
555
|
+
*/
|
|
556
|
+
label?: string;
|
|
557
|
+
/**
|
|
558
|
+
* Any CSS color for the line and its label. Theme default `$gray-500`. Applied as
|
|
559
|
+
* `--pcac-reference-line-color` on the line's group, so a stylesheet can set it on an ancestor
|
|
560
|
+
* instead (a config value wins).
|
|
561
|
+
*/
|
|
562
|
+
color?: string;
|
|
563
|
+
}
|
|
564
|
+
/**
|
|
565
|
+
* Text pinned to the plot area's corners (see `PcacLineAreaChartConfig.cornerLabels`) - names for
|
|
566
|
+
* the regions the plot divides into, such as the quadrants between two reference lines. Pinned to
|
|
567
|
+
* the plot's frame rather than to data, so they stay put when the chart is zoomed. Drawn under the
|
|
568
|
+
* series, so a point in the corner covers its label rather than the other way round. Any corner
|
|
569
|
+
* left unset is left empty.
|
|
570
|
+
*/
|
|
571
|
+
declare class PcacCornerLabels {
|
|
572
|
+
topLeft?: string;
|
|
573
|
+
topRight?: string;
|
|
574
|
+
bottomLeft?: string;
|
|
575
|
+
bottomRight?: string;
|
|
576
|
+
/**
|
|
577
|
+
* Any CSS color for all four. Theme default `$gray-600`. Applied as `--pcac-corner-label-color`
|
|
578
|
+
* on their group, so a stylesheet can set it on an ancestor instead (a config value wins).
|
|
579
|
+
*/
|
|
580
|
+
color?: string;
|
|
581
|
+
}
|
|
516
582
|
/**
|
|
517
583
|
* The axes' `format` and `domainMin`/`domainMax` (`PcacAxisConfig`) do more here than on the bar
|
|
518
584
|
* charts. `yAxis.domainMin`/`domainMax` are the y scale's domain (default 0..100). `xAxis.format`
|
|
@@ -534,10 +600,11 @@ declare class PcacLineAreaChartConfig extends PcacAxisChartConfig {
|
|
|
534
600
|
enableZoomX: boolean;
|
|
535
601
|
enableZoomY: boolean;
|
|
536
602
|
/**
|
|
537
|
-
*
|
|
538
|
-
* start when there are more series than colors, as the default palette does.
|
|
603
|
+
* Series colors, any CSS color, in place of the theme palette, one per series in order. Repeats
|
|
604
|
+
* from the start when there are more series than colors, as the default palette does. Omitted or
|
|
605
|
+
* empty, the theme palette is used - optional, as on every chart's config.
|
|
539
606
|
*/
|
|
540
|
-
colorOverride
|
|
607
|
+
colorOverride?: string[];
|
|
541
608
|
/**
|
|
542
609
|
* Bounding box for any point images (`PcacData.image`) on this chart. Optional; each field falls
|
|
543
610
|
* back to the `PcacPointImageConfig` default when not given, so a consumer only setting `image`
|
|
@@ -549,6 +616,102 @@ declare class PcacLineAreaChartConfig extends PcacAxisChartConfig {
|
|
|
549
616
|
* every `PcacPointRangeConfig` default. Points without a `range` draw nothing extra.
|
|
550
617
|
*/
|
|
551
618
|
pointRange?: Partial<PcacPointRangeConfig>;
|
|
619
|
+
/**
|
|
620
|
+
* Dashed lines at chosen values on either axis (see `PcacReferenceLine`). None when not set.
|
|
621
|
+
* They are decoration for sighted readers - hidden from screen readers like the grid - so when
|
|
622
|
+
* one carries meaning, say so in the chart's `ariaLabel`.
|
|
623
|
+
*/
|
|
624
|
+
referenceLines?: Partial<PcacReferenceLine>[];
|
|
625
|
+
/**
|
|
626
|
+
* Draw each point's `gauge` as a ring around its mark (see `PcacData.gauge`). Off when not set;
|
|
627
|
+
* `{}` turns it on with every `PcacPointGaugeConfig` default. Points without a `gauge` draw
|
|
628
|
+
* nothing extra.
|
|
629
|
+
*/
|
|
630
|
+
pointGauge?: Partial<PcacPointGaugeConfig>;
|
|
631
|
+
/**
|
|
632
|
+
* Labels in the plot's four corners (see `PcacCornerLabels`). None when not set. Hidden from
|
|
633
|
+
* screen readers like the grid, so when they carry meaning, say so in the chart's `ariaLabel`.
|
|
634
|
+
*/
|
|
635
|
+
cornerLabels?: PcacCornerLabels;
|
|
636
|
+
}
|
|
637
|
+
|
|
638
|
+
/**
|
|
639
|
+
* A dot plot: every point placed along one value axis (x), and points that share a value - or,
|
|
640
|
+
* with `binWidth`, fall in the same bin - stacked into a column above it, one mark per point. It
|
|
641
|
+
* shows how values are distributed while keeping every item visible and hoverable, which suits
|
|
642
|
+
* items with their own identity (and their own `image`) better than a histogram's bars.
|
|
643
|
+
*
|
|
644
|
+
* `data` is series, each holding its points - the same shape as the plot chart - so points can be
|
|
645
|
+
* colored by group. A point's `value` is its position on the axis and its `key` its name (in the
|
|
646
|
+
* tooltip and to screen readers). A point whose `value` isn't a number is left out, as is a series
|
|
647
|
+
* or point with `hide`.
|
|
648
|
+
*
|
|
649
|
+
* The axes: `xAxis` is the value axis - `domainMin` / `domainMax` fix its span (by default it
|
|
650
|
+
* spans the data, rounded out to nice ticks), `format` formats its ticks and the tooltip's value,
|
|
651
|
+
* and every label, sub label, tick and grid setting applies. There is no y scale - a column's
|
|
652
|
+
* height is a count of marks, not a value - so the y axis is never drawn; `yAxis` is ignored.
|
|
653
|
+
*/
|
|
654
|
+
declare class PcacDotPlotChartConfig extends PcacAxisChartConfig {
|
|
655
|
+
/**
|
|
656
|
+
* Group values into bins this wide, in the axis's units, and stack each bin at its center: with
|
|
657
|
+
* values 7, 7.5 and 8 and a `binWidth` of 1, the 7 and 7.5 share a column. Unset (the default),
|
|
658
|
+
* only equal values stack. Bins start at `xAxis.domainMin`, or 0 without one.
|
|
659
|
+
*/
|
|
660
|
+
binWidth?: number;
|
|
661
|
+
/**
|
|
662
|
+
* Radius of a point's dot, in px; default 6. Points with an `image` are sized by `pointImage`
|
|
663
|
+
* instead. Optional, as `colorOverride` is on every chart, so an object literal needn't spell it out.
|
|
664
|
+
*/
|
|
665
|
+
dotRadius?: number;
|
|
666
|
+
/** Space between marks stacked in a column, in px; default 2. Optional, likewise. */
|
|
667
|
+
gap?: number;
|
|
668
|
+
/**
|
|
669
|
+
* Bounding box for points' images (`PcacData.image`), drawn in place of their dots, as on the
|
|
670
|
+
* plot chart. Each field falls back to its `PcacPointImageConfig` default.
|
|
671
|
+
*
|
|
672
|
+
* A column too tall for the chart's height shrinks every mark on the chart evenly until it fits,
|
|
673
|
+
* so no point is ever cut off; give the chart more `height` to keep marks at full size.
|
|
674
|
+
*/
|
|
675
|
+
pointImage?: Partial<PcacPointImageConfig>;
|
|
676
|
+
/**
|
|
677
|
+
* Series colors, any CSS color, in place of the theme palette, one per series in order. Repeats
|
|
678
|
+
* when there are more series than colors. Omitted or empty, the theme palette is used.
|
|
679
|
+
*/
|
|
680
|
+
colorOverride?: string[];
|
|
681
|
+
}
|
|
682
|
+
|
|
683
|
+
/** A dot plot: points along one value axis, stacked into columns where they share a value (see PcacDotPlotChartConfig). */
|
|
684
|
+
declare class PcacDotPlotChart {
|
|
685
|
+
private chartBuilder;
|
|
686
|
+
readonly config: _angular_core.InputSignal<PcacDotPlotChartConfig>;
|
|
687
|
+
private readonly chartElm;
|
|
688
|
+
readonly dotClicked: _angular_core.OutputRef<_pioneer_code_pioneer_charts.PcacData>;
|
|
689
|
+
/** Optional consumer `<ng-template pcacTooltip>`, replacing the default tooltip (see PcacTooltipDirective). */
|
|
690
|
+
readonly tooltipTemplate: _angular_core.Signal<PcacTooltipDirective | undefined>;
|
|
691
|
+
constructor();
|
|
692
|
+
private buildChart;
|
|
693
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<PcacDotPlotChart, never>;
|
|
694
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<PcacDotPlotChart, "pcac-dot-plot-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "dotClicked": "dotClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
695
|
+
}
|
|
696
|
+
|
|
697
|
+
declare class PcacLegendConfigItem {
|
|
698
|
+
label: string;
|
|
699
|
+
checked: boolean;
|
|
700
|
+
colorOverride: string | null;
|
|
701
|
+
}
|
|
702
|
+
declare class PcacLegendConfig {
|
|
703
|
+
heading: string | null;
|
|
704
|
+
items: PcacLegendConfigItem[];
|
|
705
|
+
}
|
|
706
|
+
declare class PcacLegend {
|
|
707
|
+
readonly headingId: string;
|
|
708
|
+
private readonly colorService;
|
|
709
|
+
config: _angular_core.ModelSignal<PcacLegendConfig>;
|
|
710
|
+
itemClicked: _angular_core.OutputEmitterRef<PcacLegendConfigItem[]>;
|
|
711
|
+
colorScale: _angular_core.Signal<string[]>;
|
|
712
|
+
onItemClicked(index: number): void;
|
|
713
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<PcacLegend, never>;
|
|
714
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<PcacLegend, "pcac-legend", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "config": "configChange"; "itemClicked": "itemClicked"; }, never, never, true, never>;
|
|
552
715
|
}
|
|
553
716
|
|
|
554
717
|
/**
|
|
@@ -602,7 +765,7 @@ declare class PcacPlotChartConfig extends PcacLineAreaChartConfig {
|
|
|
602
765
|
|
|
603
766
|
declare class PcacPlotChart {
|
|
604
767
|
readonly config: _angular_core.InputSignal<PcacPlotChartConfig>;
|
|
605
|
-
readonly types: typeof PcacLineAreaPlotChartConfigType;
|
|
768
|
+
protected readonly types: typeof PcacLineAreaPlotChartConfigType;
|
|
606
769
|
readonly dotClicked: _angular_core.OutputEmitterRef<PcacData>;
|
|
607
770
|
/**
|
|
608
771
|
* Optional consumer `<ng-template pcacTooltip>` projected into this element, forwarded to the
|
|
@@ -618,7 +781,7 @@ declare class PcacLineChartConfig extends PcacLineAreaChartConfig {
|
|
|
618
781
|
|
|
619
782
|
declare class PcacLineChart {
|
|
620
783
|
readonly config: _angular_core.InputSignal<PcacLineChartConfig>;
|
|
621
|
-
readonly types: typeof PcacLineAreaPlotChartConfigType;
|
|
784
|
+
protected readonly types: typeof PcacLineAreaPlotChartConfigType;
|
|
622
785
|
readonly dotClicked: _angular_core.OutputEmitterRef<PcacData>;
|
|
623
786
|
/**
|
|
624
787
|
* Optional consumer `<ng-template pcacTooltip>` projected into this element, forwarded to the
|
|
@@ -634,7 +797,7 @@ declare class PcacAreaChartConfig extends PcacLineAreaChartConfig {
|
|
|
634
797
|
|
|
635
798
|
declare class PcacAreaChart {
|
|
636
799
|
readonly config: _angular_core.InputSignal<PcacAreaChartConfig>;
|
|
637
|
-
readonly types: typeof PcacLineAreaPlotChartConfigType;
|
|
800
|
+
protected readonly types: typeof PcacLineAreaPlotChartConfigType;
|
|
638
801
|
readonly dotClicked: _angular_core.OutputEmitterRef<PcacData>;
|
|
639
802
|
/**
|
|
640
803
|
* Optional consumer `<ng-template pcacTooltip>` projected into this element, forwarded to the
|
|
@@ -645,6 +808,73 @@ declare class PcacAreaChart {
|
|
|
645
808
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<PcacAreaChart, "pcac-area-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "dotClicked": "dotClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
646
809
|
}
|
|
647
810
|
|
|
811
|
+
/**
|
|
812
|
+
* A proximity chart: one item in the middle (`center`) and others (`data`) around it, each placed
|
|
813
|
+
* closer in or further out by its `value` - how similar it is to the center, say, or how far from
|
|
814
|
+
* it. It answers "what's nearest to this?" at a glance: the closest matches sit tight around the
|
|
815
|
+
* center, weaker ones out on the rim.
|
|
816
|
+
*
|
|
817
|
+
* Each item in `data` is one point: `key` is its name (tooltip, screen readers), `value` its
|
|
818
|
+
* closeness in whatever units the chart's `closeValue` / `farValue` use, and `image` optionally
|
|
819
|
+
* drawn in place of its dot. Items go around the center clockwise from `startAngle` in data order,
|
|
820
|
+
* evenly spaced, so put the closest first to have it at the top. An item whose `value` isn't a
|
|
821
|
+
* number, or with `hide`, is left out. Best with a handful to a dozen or so items; past that they
|
|
822
|
+
* crowd one another around the ring.
|
|
823
|
+
*/
|
|
824
|
+
declare class PcacProximityChartConfig extends PcacChartConfig {
|
|
825
|
+
/** The item the others are measured against, drawn in the middle. Its `value` isn't used. */
|
|
826
|
+
center: PcacData;
|
|
827
|
+
/**
|
|
828
|
+
* The `value` that sits right up against the center, and the one that sits on the outer rim;
|
|
829
|
+
* values in between are placed proportionally, and anything beyond either is held at it.
|
|
830
|
+
* The defaults suit a similarity from 0 to 1 (1 = identical, closest in). For a distance, swap
|
|
831
|
+
* them: `closeValue: 0, farValue: <largest distance>`.
|
|
832
|
+
*/
|
|
833
|
+
closeValue?: number;
|
|
834
|
+
farValue?: number;
|
|
835
|
+
/**
|
|
836
|
+
* Values to draw a faint guide ring at, each labelled in `format` - e.g. `[0.95, 0.9, 0.85]` with
|
|
837
|
+
* `Percentage` reads "95%", "90%", "85%". None when not set.
|
|
838
|
+
*/
|
|
839
|
+
rings?: number[];
|
|
840
|
+
/** How values read on the ring labels, in the tooltip and to screen readers; see `PcacFormatEnum`. */
|
|
841
|
+
format?: PcacFormatEnum;
|
|
842
|
+
/**
|
|
843
|
+
* Write each item's `key` under it, and the center's under the center. Default false: names are
|
|
844
|
+
* in the tooltip either way. Keep it off for long names or a crowded ring.
|
|
845
|
+
*/
|
|
846
|
+
showLabels?: boolean;
|
|
847
|
+
/** Draw a faint line from the center to each item. Default true. */
|
|
848
|
+
showSpokes?: boolean;
|
|
849
|
+
/** Where the first item sits, in degrees clockwise from 12 o'clock. Default 0. */
|
|
850
|
+
startAngle?: number;
|
|
851
|
+
/** Size of the center item's image (or twice its dot's radius), in px. Default 64. */
|
|
852
|
+
centerSize?: number;
|
|
853
|
+
/** Size of each surrounding item's image (or twice its dot's radius), in px. Default 40. */
|
|
854
|
+
itemSize?: number;
|
|
855
|
+
/**
|
|
856
|
+
* Item colors, any CSS color, used in data order for the dots of items without an `image` (the
|
|
857
|
+
* center takes the first). Repeated when there are more items than colors. Omitted or empty, the
|
|
858
|
+
* theme palette is used.
|
|
859
|
+
*/
|
|
860
|
+
colorOverride?: string[];
|
|
861
|
+
}
|
|
862
|
+
|
|
863
|
+
/** A proximity chart: an item in the middle, others around it by closeness (see PcacProximityChartConfig). */
|
|
864
|
+
declare class PcacProximityChart {
|
|
865
|
+
private chartBuilder;
|
|
866
|
+
readonly config: _angular_core.InputSignal<PcacProximityChartConfig>;
|
|
867
|
+
private readonly chartElm;
|
|
868
|
+
/** An item - or the center - was clicked, or activated with Enter or Space. */
|
|
869
|
+
readonly itemClicked: _angular_core.OutputRef<_pioneer_code_pioneer_charts.PcacData>;
|
|
870
|
+
/** Optional consumer `<ng-template pcacTooltip>`, replacing the default tooltip (see PcacTooltipDirective). */
|
|
871
|
+
readonly tooltipTemplate: _angular_core.Signal<PcacTooltipDirective | undefined>;
|
|
872
|
+
constructor();
|
|
873
|
+
private buildChart;
|
|
874
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<PcacProximityChart, never>;
|
|
875
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<PcacProximityChart, "pcac-proximity-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "itemClicked": "itemClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
876
|
+
}
|
|
877
|
+
|
|
648
878
|
/** Which chart the shared `<pcac-pie-donut-chart>` draws; each wrapper binds its own. */
|
|
649
879
|
declare enum PcacPieDonutChartType {
|
|
650
880
|
Pie = "pie",
|
|
@@ -669,7 +899,7 @@ declare class PcacPieChartConfig extends PcacPieDonutChartConfig {
|
|
|
669
899
|
|
|
670
900
|
declare class PcacPieChart {
|
|
671
901
|
readonly config: _angular_core.InputSignal<PcacPieChartConfig>;
|
|
672
|
-
readonly types: typeof PcacPieDonutChartType;
|
|
902
|
+
protected readonly types: typeof PcacPieDonutChartType;
|
|
673
903
|
readonly sliceClicked: _angular_core.OutputEmitterRef<PcacData>;
|
|
674
904
|
/**
|
|
675
905
|
* Optional consumer `<ng-template pcacTooltip>` projected into this element, forwarded to the
|
|
@@ -709,7 +939,7 @@ declare class PcacDonutChartConfig extends PcacPieDonutChartConfig {
|
|
|
709
939
|
|
|
710
940
|
declare class PcacDonutChart {
|
|
711
941
|
readonly config: _angular_core.InputSignal<PcacDonutChartConfig>;
|
|
712
|
-
readonly types: typeof PcacPieDonutChartType;
|
|
942
|
+
protected readonly types: typeof PcacPieDonutChartType;
|
|
713
943
|
readonly sliceClicked: _angular_core.OutputEmitterRef<PcacData>;
|
|
714
944
|
/**
|
|
715
945
|
* Optional consumer `<ng-template pcacTooltip>` projected into this element, forwarded to the
|
|
@@ -720,5 +950,5 @@ declare class PcacDonutChart {
|
|
|
720
950
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<PcacDonutChart, "pcac-donut-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "sliceClicked": "sliceClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
721
951
|
}
|
|
722
952
|
|
|
723
|
-
export { PcacAreaChart, PcacAreaChartConfig, PcacAxisChartConfig, PcacAxisConfig, PcacAxisSubLabels, PcacBarHorizontalChartComponent, PcacBarHorizontalChartConfig, PcacBarVerticalChartComponent, PcacBarVerticalChartConfig, PcacChartConfig, PcacColorService, PcacData, PcacDataRange, PcacDonutChart, PcacDonutChartConfig, PcacFormatEnum, PcacLegend, PcacLegendConfig, PcacLegendConfigItem, PcacLineChart, PcacLineChartConfig, PcacPieChart, PcacPieChartConfig, PcacPlotChart, PcacPlotChartConfig, PcacPointFanOutConfig, PcacPointImageConfig, PcacPointRangeConfig, PcacPointRangeShow, PcacPointRangeStyle, PcacRangeBounds, PcacTooltipDirective };
|
|
953
|
+
export { PcacAreaChart, PcacAreaChartConfig, PcacAxisChartConfig, PcacAxisConfig, PcacAxisSubLabels, PcacBarHorizontalChart, PcacBarHorizontalChart as PcacBarHorizontalChartComponent, PcacBarHorizontalChartConfig, PcacBarVerticalChart, PcacBarVerticalChart as PcacBarVerticalChartComponent, PcacBarVerticalChartConfig, PcacChartConfig, PcacColorService, PcacCornerLabels, PcacData, PcacDataRange, PcacDonutChart, PcacDonutChartConfig, PcacDotPlotChart, PcacDotPlotChartConfig, PcacFormatEnum, PcacLegend, PcacLegendConfig, PcacLegendConfigItem, PcacLineChart, PcacLineChartConfig, PcacPieChart, PcacPieChartConfig, PcacPlotChart, PcacPlotChartConfig, PcacPointFanOutConfig, PcacPointGaugeConfig, PcacPointImageConfig, PcacPointRangeConfig, PcacPointRangeShow, PcacPointRangeStyle, PcacProximityChart, PcacProximityChartConfig, PcacRangeBounds, PcacReferenceLine, PcacTooltipDirective };
|
|
724
954
|
export type { PcacTooltipCoincident, PcacTooltipContext };
|