@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.
@@ -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, ElementRef } from '@angular/core';
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. Color comes from the theme
94
- * (`.pcac-axis-tick-marks .tick line`, `$gray-900`, the same as the axis line).
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. Color comes from the theme
110
- * (`.pcac-axis-line .domain`, `$gray-900`).
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 ignores it. Default `None`, which
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. Empty,
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: string[];
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 PcacBarHorizontalChartComponent {
358
+ declare class PcacBarHorizontalChart {
347
359
  private chartBuilder;
348
360
  readonly config: _angular_core.InputSignal<PcacBarHorizontalChartConfig>;
349
- readonly chartElm: _angular_core.Signal<ElementRef<any>>;
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(): void;
358
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<PcacBarHorizontalChartComponent, never>;
359
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<PcacBarHorizontalChartComponent, "pcac-bar-horizontal-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "barClicked": "barClicked"; }, ["tooltipTemplate"], never, true, never>;
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. Empty,
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: string[];
383
+ colorOverride?: string[];
372
384
  }
373
385
 
374
- declare class PcacBarVerticalChartComponent {
386
+ declare class PcacBarVerticalChart {
375
387
  private chartBuilder;
376
388
  readonly config: _angular_core.InputSignal<PcacBarVerticalChartConfig>;
377
- readonly chartElm: _angular_core.Signal<ElementRef<any>>;
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(): void;
386
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<PcacBarVerticalChartComponent, never>;
387
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<PcacBarVerticalChartComponent, "pcac-bar-vertical-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "barClicked": "barClicked"; }, ["tooltipTemplate"], never, true, never>;
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
- * Hex color codes to override the default colors, one per series in order. Repeats from the
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: string[];
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 };