@visionaris-bruno/vs-echarts 6.5.2 → 7.1.0

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: SeriesOption & BarSeriesOption & LineSeriesOption & ScatterSeriesOption & SunburstSeriesOption): void;
     addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
     addPolar(): void;
     addXAxis(data: {
@@ -70,6 +75,9 @@ interface IScatterOptionsOverrides {
 interface IFunnelOptionsOverrides {
     series?: Partial<FunnelSeriesOption>;
 }
+interface ISunburstOptionsOverrides {
+    series?: Partial<SunburstSeriesOption>;
+}
 interface IAxisOptionsOverrides {
     categoryAxis: CategoryAxisBaseOption[];
     valueAxis: ValueAxisBaseOption[];
@@ -96,6 +104,8 @@ interface IOptionsOverrides {
     scatter: IScatterOptionsOverrides;
     /** funnel options overrides */
     funnel: IFunnelOptionsOverrides;
+    /** sunburst options overrides */
+    sunburst: ISunburstOptionsOverrides;
 }
 type NGXEchartsSelectChangeEventData = {
     type: string;
@@ -116,14 +126,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 +153,8 @@ interface IEChartSeries {
  *
  */
 interface IEChartData {
-    categories: string[];
-    categoryKeys?: string[];
-    series: IEChartSeries[];
+    categories: IEChartCategoryNode[];
+    series: IEChartSeriesNode[];
 }
 /**
  * EChartValueFormatter
@@ -195,6 +215,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 {
@@ -229,7 +250,7 @@ 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(makeOpts?: MakeOpts): void;
     /**
      * Opciones de series escenciales, inmutables y estaticas minimas
      * necesarias para el dibujado de las series del grafico.
@@ -652,5 +673,53 @@ declare abstract class EchartsScatterComponent extends BaseEchartsComponent {
     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;
+    protected updateChartOptions(): 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.0",
   "peerDependencies": {
     "@angular/common": "^20.3.0",
     "@angular/core": "^20.3.0",