@visionaris-bruno/vs-echarts 7.1.3 → 8.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/index.d.ts CHANGED
@@ -5,6 +5,13 @@ import { LineSeriesOption, BarSeriesOption, PieSeriesOption, ScatterSeriesOption
5
5
  import { CategoryAxisBaseOption, ValueAxisBaseOption } from 'echarts/types/src/coord/axisCommonTypes.js';
6
6
  import { TooltipOption } from 'echarts/types/dist/shared';
7
7
 
8
+ interface ISeriesLayoutOpts {
9
+ coordinateSystem?: 'cartesian2d' | 'polar';
10
+ axisTypes?: {
11
+ x: 'category' | 'value';
12
+ y: 'category' | 'value';
13
+ };
14
+ }
8
15
  type ChartKey = keyof Omit<IOptionsOverridesWrapper, "axis" | "tooltip">;
9
16
  /** los recibira el director
10
17
  *
@@ -13,7 +20,7 @@ type VSEChartProduct = {
13
20
  chartKey: ChartKey;
14
21
  baseOptions: EChartsOption;
15
22
  };
16
- interface IEChartBuilder<SeriesType = SeriesOption> {
23
+ interface IEChartBuilder<SeriesType = SeriesOption, OptsType = any> {
17
24
  /** producto base */
18
25
  baseProduct: VSEChartProduct;
19
26
  reset(): void;
@@ -22,15 +29,11 @@ interface IEChartBuilder<SeriesType = SeriesOption> {
22
29
  * @param data
23
30
  * @param overrides
24
31
  */
25
- addSeries(data: IEChartData, overrides: SeriesType): void;
32
+ addSeries(data: IEChartData, overrides: SeriesType, opts?: OptsType): void;
26
33
  addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
27
34
  addPolar(): void;
28
- addXAxis(data: {
29
- categories: IEChartData["categories"];
30
- }, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
31
- addYAxis(data: {
32
- categories: IEChartData["categories"];
33
- }, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
35
+ addXAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
36
+ addYAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
34
37
  addRadiusAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
35
38
  addAngleAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
36
39
  addLegend(): void;
@@ -127,35 +130,28 @@ type NGXEchartsSelectChangeEventData = {
127
130
  };
128
131
 
129
132
  /**
130
- * IEChartCategoryNode
133
+ * IEChartDataNode
131
134
  *
132
- * Representa un nodo en el árbol de categorías (filas).
135
+ * Representa un nodo/fila en el arreglo de objetos jerárquico.
133
136
  */
134
- interface IEChartCategoryNode {
135
- name: string;
136
- key?: string;
137
- children?: IEChartCategoryNode[];
137
+ interface IEChartDataNode {
138
+ category: string;
139
+ [key: string]: any;
140
+ children?: IEChartDataNode[];
138
141
  }
139
- /**
140
- * IEChartSeriesNode
141
- *
142
- * Representa un nodo en el árbol de series (columnas/medidas).
143
- */
144
- interface IEChartSeriesNode {
142
+ interface IEChartDimension {
145
143
  name: string;
146
- originalKey?: string;
147
- data: number[];
148
- children?: IEChartSeriesNode[];
144
+ displayName?: string;
149
145
  }
150
146
  /**
151
147
  * IEChartData
152
148
  *
153
- * Interfaz unificada para el paso de datos a componentes de ECharts.
149
+ * Interfaz unificada para el paso de datos basados en dataset a componentes de ECharts.
154
150
  *
155
151
  */
156
152
  interface IEChartData {
157
- categories: IEChartCategoryNode[];
158
- series: IEChartSeriesNode[];
153
+ dimensions: IEChartDimension[];
154
+ source: IEChartDataNode[];
159
155
  }
160
156
  /**
161
157
  * EChartValueFormatter
@@ -208,7 +204,7 @@ type MakeScatterOpts = MakeOpts;
208
204
  */
209
205
  declare class VSECDirector {
210
206
  private builder;
211
- constructor(builder: IEChartBuilder<any>);
207
+ constructor(builder: IEChartBuilder<any, ISeriesLayoutOpts>);
212
208
  makeBar(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeBarOpts): void;
213
209
  makeBarRadial(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeBarOpts): void;
214
210
  makeLine(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeLineOpts): void;
@@ -335,12 +331,8 @@ declare class RingBuilder implements IEChartBuilder<PieSeriesOption> {
335
331
  addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
336
332
  addLegend(): void;
337
333
  addPolar(): void;
338
- addXAxis(data: {
339
- categories: IEChartData["categories"];
340
- }, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
341
- addYAxis(data: {
342
- categories: IEChartData["categories"];
343
- }, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
334
+ addXAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
335
+ addYAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
344
336
  addRadiusAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
345
337
  addAngleAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
346
338
  setValueFormatter(formatter: EChartValueFormatter | undefined): void;
@@ -402,12 +394,8 @@ declare class PieBuilder implements IEChartBuilder<PieSeriesOption> {
402
394
  addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
403
395
  addLegend(): void;
404
396
  addPolar(): void;
405
- addXAxis(data: {
406
- categories: IEChartData["categories"];
407
- }, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
408
- addYAxis(data: {
409
- categories: IEChartData["categories"];
410
- }, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
397
+ addXAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
398
+ addYAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
411
399
  addRadiusAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
412
400
  addAngleAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
413
401
  addGraphic(): void;
@@ -454,12 +442,8 @@ declare class FunnelBuilder implements IEChartBuilder<FunnelSeriesOption> {
454
442
  addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
455
443
  addLegend(): void;
456
444
  addPolar(): void;
457
- addXAxis(data: {
458
- categories: IEChartData["categories"];
459
- }, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
460
- addYAxis(data: {
461
- categories: IEChartData["categories"];
462
- }, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
445
+ addXAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
446
+ addYAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type: 'category' | 'value'): void;
463
447
  addRadiusAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
464
448
  addAngleAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
465
449
  addGraphic(): void;
@@ -493,7 +477,7 @@ declare class EchartsFunnelComponent extends BaseEchartsComponent {
493
477
  *
494
478
  * Puede verse utilizado en graficos como Lineas y Bars. Siempre que se pueda priorizar utilizar este.
495
479
  */
496
- declare class EChartBuilder implements IEChartBuilder<SeriesOption & BarSeriesOption & LineSeriesOption & ScatterSeriesOption> {
480
+ declare class EChartBuilder implements IEChartBuilder<SeriesOption & BarSeriesOption & LineSeriesOption & ScatterSeriesOption, ISeriesLayoutOpts> {
497
481
  baseProduct: VSEChartProduct;
498
482
  protected valueFormatter: EChartValueFormatter;
499
483
  protected palette: string[];
@@ -508,7 +492,7 @@ declare class EChartBuilder implements IEChartBuilder<SeriesOption & BarSeriesOp
508
492
  * @param overrides
509
493
  * @returns
510
494
  */
511
- addSeries(data: IEChartData, overrides: SeriesOption & BarSeriesOption & LineSeriesOption & ScatterSeriesOption): void;
495
+ addSeries(data: IEChartData, overrides: SeriesOption & BarSeriesOption & LineSeriesOption & ScatterSeriesOption, opts?: ISeriesLayoutOpts): void;
512
496
  /**
513
497
  * TODO: Mejorar funcion, no me convence como se implemento el tooltip formatter.
514
498
  * @param data
@@ -516,12 +500,8 @@ declare class EChartBuilder implements IEChartBuilder<SeriesOption & BarSeriesOp
516
500
  */
517
501
  addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
518
502
  addPolar(): void;
519
- addXAxis(data: {
520
- categories: IEChartData["categories"];
521
- }, overrides: IOptionsOverrides["axis"], type?: 'category' | 'value'): void;
522
- addYAxis(data: {
523
- categories: IEChartData["categories"];
524
- }, overrides: IOptionsOverrides["axis"], type?: 'category' | 'value'): void;
503
+ addXAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type?: 'category' | 'value'): void;
504
+ addYAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type?: 'category' | 'value'): void;
525
505
  addRadiusAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
526
506
  addAngleAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
527
507
  addLegend(): void;
@@ -543,12 +523,8 @@ declare class EChartBuilder implements IEChartBuilder<SeriesOption & BarSeriesOp
543
523
  * Permite inyectar un resolver de colores dinámico.
544
524
  */
545
525
  setColorResolver(resolver: ChartColorResolver): void;
546
- protected getCategoryAxisOptions(data: {
547
- categories: IEChartData["categories"];
548
- }, overrides: IOptionsOverrides["axis"]): CategoryAxisBaseOption;
549
- protected getValueAxisOptions(data: {
550
- categories: IEChartData["categories"];
551
- }, overrides: IOptionsOverrides["axis"]): any;
526
+ protected getCategoryAxisOptions(data: IEChartData, overrides: IOptionsOverrides["axis"]): CategoryAxisBaseOption;
527
+ protected getValueAxisOptions(data: IEChartData, overrides: IOptionsOverrides["axis"]): any;
552
528
  }
553
529
 
554
530
  declare abstract class EchartsBarComponent extends BaseEchartsComponent {
@@ -577,7 +553,7 @@ declare class EChartsHBarComponent extends EchartsBarComponent {
577
553
  protected director: VSECDirector;
578
554
  protected make(): void;
579
555
  static ɵfac: i0.ɵɵFactoryDeclaration<EChartsHBarComponent, never>;
580
- static ɵcmp: i0.ɵɵComponentDeclaration<EChartsHBarComponent, "vs-echarts-bar", never, {}, {}, never, never, true, never>;
556
+ static ɵcmp: i0.ɵɵComponentDeclaration<EChartsHBarComponent, "vs-echarts-hbar", never, {}, {}, never, never, true, never>;
581
557
  }
582
558
 
583
559
  declare class EChartsBarStackedComponent extends EchartsBarComponent {
@@ -586,7 +562,7 @@ declare class EChartsBarStackedComponent extends EchartsBarComponent {
586
562
  protected builder: EChartBuilder;
587
563
  protected director: VSECDirector;
588
564
  static ɵfac: i0.ɵɵFactoryDeclaration<EChartsBarStackedComponent, never>;
589
- static ɵcmp: i0.ɵɵComponentDeclaration<EChartsBarStackedComponent, "vs-echarts-bar", never, {}, {}, never, never, true, never>;
565
+ static ɵcmp: i0.ɵɵComponentDeclaration<EChartsBarStackedComponent, "vs-echarts-stacked-bar", never, {}, {}, never, never, true, never>;
590
566
  }
591
567
 
592
568
  declare class EChartsHBarStackedComponent extends EchartsBarComponent {
@@ -596,7 +572,7 @@ declare class EChartsHBarStackedComponent extends EchartsBarComponent {
596
572
  protected director: VSECDirector;
597
573
  protected make(): void;
598
574
  static ɵfac: i0.ɵɵFactoryDeclaration<EChartsHBarStackedComponent, never>;
599
- static ɵcmp: i0.ɵɵComponentDeclaration<EChartsHBarStackedComponent, "vs-echarts-bar", never, {}, {}, never, never, true, never>;
575
+ static ɵcmp: i0.ɵɵComponentDeclaration<EChartsHBarStackedComponent, "vs-echarts-hbar-stacked", never, {}, {}, never, never, true, never>;
600
576
  }
601
577
 
602
578
  declare class EChartsBarStackedRadialComponent extends EchartsBarComponent {
@@ -606,7 +582,7 @@ declare class EChartsBarStackedRadialComponent extends EchartsBarComponent {
606
582
  protected director: VSECDirector;
607
583
  protected make(): void;
608
584
  static ɵfac: i0.ɵɵFactoryDeclaration<EChartsBarStackedRadialComponent, never>;
609
- static ɵcmp: i0.ɵɵComponentDeclaration<EChartsBarStackedRadialComponent, "vs-echarts-bar", never, {}, {}, never, never, true, never>;
585
+ static ɵcmp: i0.ɵɵComponentDeclaration<EChartsBarStackedRadialComponent, "vs-echarts-bar-stacked-radial", never, {}, {}, never, never, true, never>;
610
586
  }
611
587
 
612
588
  declare abstract class EchartsLineComponent extends BaseEchartsComponent {
@@ -631,7 +607,7 @@ declare class EChartsAreaComponent extends EchartsLineComponent {
631
607
  protected builder: EChartBuilder;
632
608
  protected director: VSECDirector;
633
609
  static ɵfac: i0.ɵɵFactoryDeclaration<EChartsAreaComponent, never>;
634
- static ɵcmp: i0.ɵɵComponentDeclaration<EChartsAreaComponent, "vs-echarts-bar", never, {}, {}, never, never, true, never>;
610
+ static ɵcmp: i0.ɵɵComponentDeclaration<EChartsAreaComponent, "vs-echarts-area", never, {}, {}, never, never, true, never>;
635
611
  }
636
612
 
637
613
  declare class EChartsAreaStackComponent extends EchartsLineComponent {
@@ -640,7 +616,7 @@ declare class EChartsAreaStackComponent extends EchartsLineComponent {
640
616
  protected builder: EChartBuilder;
641
617
  protected director: VSECDirector;
642
618
  static ɵfac: i0.ɵɵFactoryDeclaration<EChartsAreaStackComponent, never>;
643
- static ɵcmp: i0.ɵɵComponentDeclaration<EChartsAreaStackComponent, "vs-echarts-bar", never, {}, {}, never, never, true, never>;
619
+ static ɵcmp: i0.ɵɵComponentDeclaration<EChartsAreaStackComponent, "vs-echarts-area-stack", never, {}, {}, never, never, true, never>;
644
620
  }
645
621
 
646
622
  declare abstract class EchartsScatterComponent extends BaseEchartsComponent {
@@ -673,12 +649,8 @@ declare class SunburstBuilder implements IEChartBuilder<SunburstSeriesOption> {
673
649
  addSeries(data: IEChartData, overrides: SunburstSeriesOption): void;
674
650
  addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
675
651
  addPolar(): void;
676
- addXAxis(data: {
677
- categories: IEChartData["categories"];
678
- }, overrides: IOptionsOverrides["axis"], type: "category" | "value"): void;
679
- addYAxis(data: {
680
- categories: IEChartData["categories"];
681
- }, overrides: IOptionsOverrides["axis"], type: "category" | "value"): void;
652
+ addXAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type: "category" | "value"): void;
653
+ addYAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type: "category" | "value"): void;
682
654
  addRadiusAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
683
655
  addAngleAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
684
656
  addLegend(): void;
@@ -710,4 +682,4 @@ declare class EChartsSunburstComponent extends BaseEchartsComponent {
710
682
  }
711
683
 
712
684
  export { BaseEchartsComponent, EChartsAreaComponent, EChartsAreaStackComponent, EChartsBarStackedComponent, EChartsBarStackedRadialComponent, EChartsHBarComponent, EChartsHBarStackedComponent, EChartsSunburstComponent, EchartsBarComponent, EchartsFunnelComponent, EchartsLineComponent, EchartsPieComponent, EchartsRingComponent, EchartsScatterComponent, defaultOptionsOverrides, initializeEcharts, provideVSEcharts };
713
- export type { ChartColorResolver, ChartOrientation, EChartClickType, EChartValueFormatter, IAreaOptionsOverrides, IAreaStackOptionsOverrides, IAxisOptionsOverrides, IBarOptionsOverrides, IBarStackedOptionsOverrides, IBarStackedRadialOptionsOverrides, IEChartBuilder, IEChartCategoryNode, IEChartData, IEChartSeriesNode, IFunnelOptionsOverrides, IHBarOptionsOverrides, IHBarStackedOptionsOverrides, ILineOptionsOverrides, IOptionsOverrides, IOptionsOverridesWrapper, IPieOptionsOverrides, IRingOptionsOverrides, IScatterOptionsOverrides, ISunburstOptionsOverrides, ITooltipOptionsOverrides, NGXEchartsSelectChangeEventData, VSEChartProduct };
685
+ export type { ChartColorResolver, ChartOrientation, EChartClickType, EChartValueFormatter, IAreaOptionsOverrides, IAreaStackOptionsOverrides, IAxisOptionsOverrides, IBarOptionsOverrides, IBarStackedOptionsOverrides, IBarStackedRadialOptionsOverrides, IEChartBuilder, IEChartData, IEChartDataNode, IEChartDimension, IFunnelOptionsOverrides, IHBarOptionsOverrides, IHBarStackedOptionsOverrides, ILineOptionsOverrides, IOptionsOverrides, IOptionsOverridesWrapper, IPieOptionsOverrides, IRingOptionsOverrides, IScatterOptionsOverrides, ISeriesLayoutOpts, ISunburstOptionsOverrides, ITooltipOptionsOverrides, NGXEchartsSelectChangeEventData, VSEChartProduct };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@visionaris-bruno/vs-echarts",
3
- "version": "7.1.3",
3
+ "version": "8.1.0",
4
4
  "peerDependencies": {
5
5
  "@angular/common": "^20.3.0",
6
6
  "@angular/core": "^20.3.0",