@visionaris-bruno/vs-echarts 6.5.2 → 7.1.3

package/index.d.ts

@@ -1,7 +1,7 @@
 import * as i0 from '@angular/core';
 import { OnChanges, OnDestroy, ElementRef, EventEmitter, SimpleChanges } from '@angular/core';
 import * as echarts from 'echarts';
-import { LineSeriesOption, BarSeriesOption, PieSeriesOption, ScatterSeriesOption, FunnelSeriesOption, EChartsOption, SeriesOption } from 'echarts';
+import { LineSeriesOption, BarSeriesOption, PieSeriesOption, ScatterSeriesOption, FunnelSeriesOption, SunburstSeriesOption, EChartsOption, SeriesOption } from 'echarts';
 import { CategoryAxisBaseOption, ValueAxisBaseOption } from 'echarts/types/src/coord/axisCommonTypes.js';
 import { TooltipOption } from 'echarts/types/dist/shared';
 
@@ -13,11 +13,16 @@ type VSEChartProduct = {
     chartKey: ChartKey;
     baseOptions: EChartsOption;
 };
-interface IEChartBuilder {
+interface IEChartBuilder<SeriesType = SeriesOption> {
     /** producto base */
     baseProduct: VSEChartProduct;
     reset(): void;
-    addSeries(data: IEChartData, overrides: SeriesOption & BarSeriesOption & LineSeriesOption & ScatterSeriesOption): void;
+    /**
+     * TODO: addSeries debe recibir el tipo de overrides por parametro SeriesType
+     * @param data
+     * @param overrides
+     */
+    addSeries(data: IEChartData, overrides: SeriesType): void;
     addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
     addPolar(): void;
     addXAxis(data: {
@@ -34,6 +39,7 @@ interface IEChartBuilder {
     setValueFormatter(formatter: EChartValueFormatter | undefined): void;
     setPalette(palette: string[] | undefined): void;
     setColorResolver(resolver: ChartColorResolver | undefined): void;
+    getResult(): EChartsOption;
 }
 type EChartClickType = 'cross-filter';
 interface IAreaOptionsOverrides extends ILineOptionsOverrides {
@@ -70,6 +76,9 @@ interface IScatterOptionsOverrides {
 interface IFunnelOptionsOverrides {
     series?: Partial<FunnelSeriesOption>;
 }
+interface ISunburstOptionsOverrides {
+    series?: Partial<SunburstSeriesOption>;
+}
 interface IAxisOptionsOverrides {
     categoryAxis: CategoryAxisBaseOption[];
     valueAxis: ValueAxisBaseOption[];
@@ -96,6 +105,8 @@ interface IOptionsOverrides {
     scatter: IScatterOptionsOverrides;
     /** funnel options overrides */
     funnel: IFunnelOptionsOverrides;
+    /** sunburst options overrides */
+    sunburst: ISunburstOptionsOverrides;
 }
 type NGXEchartsSelectChangeEventData = {
     type: string;
@@ -116,14 +127,25 @@ type NGXEchartsSelectChangeEventData = {
 };
 
 /**
- * IEChartSeries
+ * IEChartCategoryNode
  *
- * Estructura de datos para una serie de ECharts.
+ * Representa un nodo en el árbol de categorías (filas).
  */
-interface IEChartSeries {
+interface IEChartCategoryNode {
+    name: string;
+    key?: string;
+    children?: IEChartCategoryNode[];
+}
+/**
+ * IEChartSeriesNode
+ *
+ * Representa un nodo en el árbol de series (columnas/medidas).
+ */
+interface IEChartSeriesNode {
     name: string;
-    data: number[];
     originalKey?: string;
+    data: number[];
+    children?: IEChartSeriesNode[];
 }
 /**
  * IEChartData
@@ -132,9 +154,8 @@ interface IEChartSeries {
  *
  */
 interface IEChartData {
-    categories: string[];
-    categoryKeys?: string[];
-    series: IEChartSeries[];
+    categories: IEChartCategoryNode[];
+    series: IEChartSeriesNode[];
 }
 /**
  * EChartValueFormatter
@@ -187,7 +208,7 @@ type MakeScatterOpts = MakeOpts;
  */
 declare class VSECDirector {
     private builder;
-    constructor(builder: IEChartBuilder);
+    constructor(builder: IEChartBuilder<any>);
     makeBar(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeBarOpts): void;
     makeBarRadial(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeBarOpts): void;
     makeLine(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeLineOpts): void;
@@ -195,6 +216,7 @@ declare class VSECDirector {
     makeRing(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeOpts): void;
     makePie(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeOpts): void;
     makeFunnel(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeOpts): void;
+    makeSunburst(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeOpts): void;
 }
 
 declare abstract class BaseEchartsComponent implements OnChanges, OnDestroy {
@@ -219,7 +241,7 @@ declare abstract class BaseEchartsComponent implements OnChanges, OnDestroy {
      * producto base/inicial para el builder.
      */
     protected abstract baseProduct: VSEChartProduct;
-    protected abstract builder: IEChartBuilder;
+    protected abstract builder: IEChartBuilder<any>;
     /**
      * director de construcción.
      *
@@ -229,19 +251,12 @@ declare abstract class BaseEchartsComponent implements OnChanges, OnDestroy {
      * Ver: https://refactoring.guru/es/design-patterns/builder
      */
     protected abstract director: VSECDirector;
-    protected abstract make(makeOpts: MakeOpts): void;
+    protected abstract make(): void;
     /**
      * Opciones de series escenciales, inmutables y estaticas minimas
      * necesarias para el dibujado de las series del grafico.
      */
     protected abstract baseSeriesOptions: SeriesOption;
-    /** Construye y setea o actualiza las opciones.
-     *
-     * Utilizar cuando requiera un redibujo completo.
-     *
-     * Ej: Cambio en la data o estructural.
-     */
-    protected abstract updateChartOptions(): void;
     protected chartInstance?: echarts.ECharts;
     /** Opciones de inicializacion de echarts
      *
@@ -269,6 +284,7 @@ declare abstract class BaseEchartsComponent implements OnChanges, OnDestroy {
      * el comportamiento base (detectar inputs relevantes y actualizar el chart).
      */
     protected onInputChanges(changes: SimpleChanges): void;
+    private prepareOptions;
     /**
    * Gatilla actualización.
    *
@@ -305,7 +321,7 @@ declare abstract class BaseEchartsComponent implements OnChanges, OnDestroy {
  * Builder concreto para el grafico de Ring.
  *
  */
-declare class RingBuilder implements IEChartBuilder {
+declare class RingBuilder implements IEChartBuilder<PieSeriesOption> {
     baseProduct: VSEChartProduct;
     protected valueFormatter: EChartValueFormatter;
     protected palette: string[];
@@ -314,7 +330,7 @@ declare class RingBuilder implements IEChartBuilder {
     constructor(baseProduct: VSEChartProduct);
     reset(): void;
     addCommons(): void;
-    addSeries(data: IEChartData, overrides: SeriesOption): void;
+    addSeries(data: IEChartData, overrides: PieSeriesOption): void;
     addGraphic(): void;
     addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
     addLegend(): void;
@@ -350,7 +366,7 @@ declare class EchartsRingComponent extends BaseEchartsComponent {
     private selectedPercent;
     private currentGraphicText;
     constructor();
-    protected make(makeOpts: MakeOpts): void;
+    protected make(): void;
     protected onInputChanges(changes: SimpleChanges): void;
     /**
      * Maneja clics en los sectores del ring.
@@ -363,7 +379,6 @@ declare class EchartsRingComponent extends BaseEchartsComponent {
      * Actualiza el texto del Graphic central y persiste la selección en el modelo de opciones.
      */
     private setGraphicText;
-    protected updateChartOptions(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EchartsRingComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EchartsRingComponent, "vs-echarts-ring", never, {}, {}, never, never, true, never>;
 }
@@ -374,7 +389,7 @@ declare class EchartsRingComponent extends BaseEchartsComponent {
  * Builder concreto para el gráfico de Pie (torta concéntrica).
  *
  */
-declare class PieBuilder implements IEChartBuilder {
+declare class PieBuilder implements IEChartBuilder<PieSeriesOption> {
     baseProduct: VSEChartProduct;
     protected valueFormatter: EChartValueFormatter;
     protected palette: string[];
@@ -383,7 +398,7 @@ declare class PieBuilder implements IEChartBuilder {
     constructor(baseProduct: VSEChartProduct);
     reset(): void;
     addCommons(): void;
-    addSeries(data: IEChartData, overrides: SeriesOption): void;
+    addSeries(data: IEChartData, overrides: PieSeriesOption): void;
     addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
     addLegend(): void;
     addPolar(): void;
@@ -416,8 +431,7 @@ declare class EchartsPieComponent extends BaseEchartsComponent {
     protected builder: PieBuilder;
     protected director: VSECDirector;
     constructor();
-    protected make(makeOpts: MakeOpts): void;
-    protected updateChartOptions(): void;
+    protected make(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EchartsPieComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EchartsPieComponent, "vs-echarts-pie", never, {}, {}, never, never, true, never>;
 }
@@ -427,7 +441,7 @@ declare class EchartsPieComponent extends BaseEchartsComponent {
  *
  * Concrete builder for Funnel charts.
  */
-declare class FunnelBuilder implements IEChartBuilder {
+declare class FunnelBuilder implements IEChartBuilder<FunnelSeriesOption> {
     baseProduct: VSEChartProduct;
     protected valueFormatter: EChartValueFormatter;
     protected palette: string[];
@@ -436,7 +450,7 @@ declare class FunnelBuilder implements IEChartBuilder {
     constructor(baseProduct: VSEChartProduct);
     reset(): void;
     addCommons(): void;
-    addSeries(data: IEChartData, overrides: SeriesOption): void;
+    addSeries(data: IEChartData, overrides: FunnelSeriesOption): void;
     addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
     addLegend(): void;
     addPolar(): void;
@@ -467,8 +481,7 @@ declare class EchartsFunnelComponent extends BaseEchartsComponent {
     protected builder: FunnelBuilder;
     protected director: VSECDirector;
     constructor();
-    protected make(makeOpts: MakeOpts): void;
-    protected updateChartOptions(): void;
+    protected make(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EchartsFunnelComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EchartsFunnelComponent, "vs-echarts-funnel", never, {}, {}, never, never, true, never>;
 }
@@ -480,7 +493,7 @@ declare class EchartsFunnelComponent extends BaseEchartsComponent {
  *
  * Puede verse utilizado en graficos como Lineas y Bars. Siempre que se pueda priorizar utilizar este.
  */
-declare class EChartBuilder implements IEChartBuilder {
+declare class EChartBuilder implements IEChartBuilder<SeriesOption & BarSeriesOption & LineSeriesOption & ScatterSeriesOption> {
     baseProduct: VSEChartProduct;
     protected valueFormatter: EChartValueFormatter;
     protected palette: string[];
@@ -552,8 +565,7 @@ declare abstract class EchartsBarComponent extends BaseEchartsComponent {
     protected builder: EChartBuilder;
     protected director: VSECDirector;
     constructor();
-    protected make(makeOpts: MakeBarOpts): void;
-    protected updateChartOptions(): void;
+    protected make(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EchartsBarComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EchartsBarComponent, "vs-echarts-bar", never, {}, {}, never, never, true, never>;
 }
@@ -563,7 +575,7 @@ declare class EChartsHBarComponent extends EchartsBarComponent {
     protected variantBaseProduct: VSEChartProduct;
     protected builder: EChartBuilder;
     protected director: VSECDirector;
-    protected make(makeOpts: MakeBarOpts): void;
+    protected make(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EChartsHBarComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EChartsHBarComponent, "vs-echarts-bar", never, {}, {}, never, never, true, never>;
 }
@@ -582,7 +594,7 @@ declare class EChartsHBarStackedComponent extends EchartsBarComponent {
     protected variantBaseProduct: VSEChartProduct;
     protected builder: EChartBuilder;
     protected director: VSECDirector;
-    protected make(makeOpts: MakeBarOpts): void;
+    protected make(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EChartsHBarStackedComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EChartsHBarStackedComponent, "vs-echarts-bar", never, {}, {}, never, never, true, never>;
 }
@@ -592,7 +604,7 @@ declare class EChartsBarStackedRadialComponent extends EchartsBarComponent {
     protected variantBaseProduct: VSEChartProduct;
     protected builder: EChartBuilder;
     protected director: VSECDirector;
-    protected make(makeOpts: MakeBarOpts): void;
+    protected make(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EChartsBarStackedRadialComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EChartsBarStackedRadialComponent, "vs-echarts-bar", never, {}, {}, never, never, true, never>;
 }
@@ -608,8 +620,7 @@ declare abstract class EchartsLineComponent extends BaseEchartsComponent {
     */
     protected abstract variantBaseProduct: VSEChartProduct;
     constructor();
-    protected make(makeOpts: MakeLineOpts): void;
-    protected updateChartOptions(): void;
+    protected make(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EchartsLineComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EchartsLineComponent, "vs-echarts-line", never, {}, {}, never, never, true, never>;
 }
@@ -646,11 +657,57 @@ declare abstract class EchartsScatterComponent extends BaseEchartsComponent {
     protected builder: EChartBuilder;
     protected director: VSECDirector;
     constructor();
-    protected make(makeOpts: MakeScatterOpts): void;
-    protected updateChartOptions(): void;
+    protected make(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EchartsScatterComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EchartsScatterComponent, "vs-echarts-scatter", never, {}, {}, never, never, true, never>;
 }
 
-export { BaseEchartsComponent, EChartsAreaComponent, EChartsAreaStackComponent, EChartsBarStackedComponent, EChartsBarStackedRadialComponent, EChartsHBarComponent, EChartsHBarStackedComponent, EchartsBarComponent, EchartsFunnelComponent, EchartsLineComponent, EchartsPieComponent, EchartsRingComponent, EchartsScatterComponent, defaultOptionsOverrides, initializeEcharts, provideVSEcharts };
-export type { ChartColorResolver, ChartOrientation, EChartClickType, EChartValueFormatter, IAreaOptionsOverrides, IAreaStackOptionsOverrides, IAxisOptionsOverrides, IBarOptionsOverrides, IBarStackedOptionsOverrides, IBarStackedRadialOptionsOverrides, IEChartBuilder, IEChartData, IEChartSeries, IFunnelOptionsOverrides, IHBarOptionsOverrides, IHBarStackedOptionsOverrides, ILineOptionsOverrides, IOptionsOverrides, IOptionsOverridesWrapper, IPieOptionsOverrides, IRingOptionsOverrides, IScatterOptionsOverrides, ITooltipOptionsOverrides, NGXEchartsSelectChangeEventData, VSEChartProduct };
+declare class SunburstBuilder implements IEChartBuilder<SunburstSeriesOption> {
+    baseProduct: VSEChartProduct;
+    protected valueFormatter: EChartValueFormatter;
+    protected palette: string[];
+    protected colorResolver?: ChartColorResolver;
+    protected result: EChartsOption;
+    constructor(baseProduct: VSEChartProduct);
+    reset(): void;
+    addSeries(data: IEChartData, overrides: SunburstSeriesOption): void;
+    addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
+    addPolar(): void;
+    addXAxis(data: {
+        categories: IEChartData["categories"];
+    }, overrides: IOptionsOverrides["axis"], type: "category" | "value"): void;
+    addYAxis(data: {
+        categories: IEChartData["categories"];
+    }, overrides: IOptionsOverrides["axis"], type: "category" | "value"): void;
+    addRadiusAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
+    addAngleAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
+    addLegend(): void;
+    addCommons(): void;
+    addGraphic(): void;
+    getResult(): EChartsOption;
+    /**
+     * Permite inyectar un formateador de valores externo.
+     */
+    setValueFormatter(formatter: EChartValueFormatter): void;
+    /**
+     * Permite inyectar una paleta de colores básica.
+     */
+    setPalette(palette: string[]): void;
+    /**
+     * Permite inyectar un resolver de colores dinámico.
+     */
+    setColorResolver(resolver: ChartColorResolver): void;
+}
+
+declare class EChartsSunburstComponent extends BaseEchartsComponent {
+    protected baseSeriesOptions: SunburstSeriesOption;
+    protected baseProduct: VSEChartProduct;
+    protected builder: SunburstBuilder;
+    protected director: VSECDirector;
+    protected make(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EChartsSunburstComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EChartsSunburstComponent, "vs-echarts-sunburst", never, {}, {}, never, never, true, never>;
+}
+
+export { BaseEchartsComponent, EChartsAreaComponent, EChartsAreaStackComponent, EChartsBarStackedComponent, EChartsBarStackedRadialComponent, EChartsHBarComponent, EChartsHBarStackedComponent, EChartsSunburstComponent, EchartsBarComponent, EchartsFunnelComponent, EchartsLineComponent, EchartsPieComponent, EchartsRingComponent, EchartsScatterComponent, defaultOptionsOverrides, initializeEcharts, provideVSEcharts };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visionaris-bruno/vs-echarts",
-  "version": "6.5.2",
+  "version": "7.1.3",
   "peerDependencies": {
     "@angular/common": "^20.3.0",
     "@angular/core": "^20.3.0",