@visionaris-bruno/vs-echarts 6.4.1 → 6.5.1

package/index.d.ts

@@ -61,6 +61,9 @@ interface IBarOptionsOverrides {
 interface IRingOptionsOverrides {
     series?: Partial<PieSeriesOption>;
 }
+interface IPieOptionsOverrides {
+    series?: Partial<PieSeriesOption>;
+}
 interface IScatterOptionsOverrides {
     series?: Partial<ScatterSeriesOption>;
 }
@@ -87,6 +90,8 @@ interface IOptionsOverrides {
     bar: IBarOptionsOverrides;
     /** ring options overrides */
     ring: IRingOptionsOverrides;
+    /** pie options overrides */
+    pie: IPieOptionsOverrides;
     /** scatter options overrides */
     scatter: IScatterOptionsOverrides;
     /** funnel options overrides */
@@ -188,6 +193,7 @@ declare class VSECDirector {
     makeLine(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeLineOpts): void;
     makeScatter(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeScatterOpts): void;
     makeRing(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeOpts): void;
+    makePie(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeOpts): void;
     makeFunnel(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeOpts): void;
 }
 
@@ -274,12 +280,16 @@ declare abstract class BaseEchartsComponent implements OnChanges, OnDestroy {
     onChartInit(instance: any): void;
     onChartClick(event: any): void;
     /**
-     * Seleccion y des seleccion de item.
+     * Maneja el cambio de selección en el gráfico (selección y deselección de elementos).
+     * Requiere que las series del gráfico tengan configurado `selectMode`.
      *
-     * Para hacer uso de esta funcion las opciones de series
-     * del grafico deben tener seteado 'selectMode'.
+     * @param event Datos del evento de cambio de selección de ECharts.
+     * @param opts Opciones de configuración adicionales.
+     * @param opts.fixPieDataIndexInside Si es true, aplica la corrección de índice para gráficos tipo pie.
      */
-    onChartSelectChanged(event: NGXEchartsSelectChangeEventData): void;
+    onChartSelectChanged(event: NGXEchartsSelectChangeEventData, opts?: {
+        fixPieDataIndexInside?: boolean;
+    }): void;
     /**
    * Método público para forzar el redimensionado desde el padre
    */
@@ -349,7 +359,6 @@ declare class EchartsRingComponent extends BaseEchartsComponent {
     onChartClick(event: any): void;
     onChartMouseOver(event: any): void;
     onChartMouseOut(event: any): void;
-    onChartSelectChangedParcheado(e: NGXEchartsSelectChangeEventData): void;
     /**
      * Actualiza el texto del Graphic central y persiste la selección en el modelo de opciones.
      */
@@ -359,6 +368,60 @@ declare class EchartsRingComponent extends BaseEchartsComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<EchartsRingComponent, "vs-echarts-ring", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * PieBuilder
+ *
+ * Builder concreto para el gráfico de Pie (torta concéntrica).
+ *
+ */
+declare class PieBuilder implements IEChartBuilder {
+    baseProduct: VSEChartProduct;
+    protected valueFormatter: EChartValueFormatter;
+    protected palette: string[];
+    protected colorResolver?: ChartColorResolver;
+    protected result: EChartsOption;
+    constructor(baseProduct: VSEChartProduct);
+    reset(): void;
+    addCommons(): void;
+    addSeries(data: IEChartData, overrides: SeriesOption): void;
+    addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
+    addLegend(): 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;
+    addGraphic(): void;
+    setValueFormatter(formatter: EChartValueFormatter | undefined): void;
+    setPalette(palette: string[] | undefined): void;
+    setColorResolver(resolver: ChartColorResolver | undefined): void;
+    getResult(): EChartsOption;
+    private formatCellValue;
+}
+
+/**
+ * EchartsPieComponent
+ *
+ * Especialista en visualización de tipo Pie (Torta y Anillos concéntricos).
+ * La primera serie se dibuja como un gráfico de torta tradicional (lleno) y
+ * las subsecuentes como anillos concéntricos alrededor.
+ */
+declare class EchartsPieComponent extends BaseEchartsComponent {
+    protected baseSeriesOptions: PieSeriesOption;
+    protected baseProduct: VSEChartProduct;
+    protected builder: PieBuilder;
+    protected director: VSECDirector;
+    constructor();
+    protected make(makeOpts: MakeOpts): void;
+    protected updateChartOptions(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EchartsPieComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EchartsPieComponent, "vs-echarts-pie", never, {}, {}, never, never, true, never>;
+}
+
 /**
  * FunnelBuilder
  *
@@ -589,5 +652,5 @@ 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, 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, IRingOptionsOverrides, IScatterOptionsOverrides, ITooltipOptionsOverrides, NGXEchartsSelectChangeEventData, VSEChartProduct };
+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 };

package/package.json

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