@visionaris-bruno/vs-echarts 6.1.2 → 6.2.0

package/index.d.ts

@@ -3,7 +3,7 @@ import { OnChanges, OnDestroy, ElementRef, EventEmitter, SimpleChanges } from '@
 import * as echarts from 'echarts';
 import { LineSeriesOption, BarSeriesOption, PieSeriesOption, EChartsOption, SeriesOption } from 'echarts';
 import { CategoryAxisBaseOption, ValueAxisBaseOption } from 'echarts/types/src/coord/axisCommonTypes.js';
-import { TooltipOption, ECBasicOption } from 'echarts/types/dist/shared';
+import { TooltipOption } from 'echarts/types/dist/shared';
 
 type ChartKey = keyof Omit<IOptionsOverridesWrapper, "axis" | "tooltip">;
 /** los recibira el director
@@ -82,6 +82,23 @@ interface IOptionsOverrides {
     /** ring options overrides */
     ring: IRingOptionsOverrides;
 }
+type NGXEchartsSelectChangeEventData = {
+    type: string;
+    fromAction: string;
+    fromActionPayload: {
+        dataIndexInside: number;
+        dataType: unknown;
+        isFromClick: boolean;
+        seriesIndex: number;
+        type: string;
+    };
+    isFromClick: boolean;
+    selected: {
+        dataIndex: number[];
+        seriesIndex: number;
+    }[];
+    escapeConnect: unknown;
+};
 
 /**
  * IEChartSeries
@@ -199,11 +216,14 @@ declare abstract class BaseEchartsComponent implements OnChanges, OnDestroy {
      * 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;
-    protected currentLegendSelected: any;
-    /** Estado de selección para filtros cruzados */
-    protected selectedCategoryIndex: number | null;
-    protected selectedSeriesIndex: number | null;
     /** Opciones de inicializacion de echarts
      *
      * NgxEchartsDirective.initOpts
@@ -211,38 +231,18 @@ declare abstract class BaseEchartsComponent implements OnChanges, OnDestroy {
     initOptions: {
         renderer: string;
     };
-    /** Opciones configuradas para ngx-echarts */
-    chartOptions: any;
-    mergeOptions: ECBasicOption;
     constructor();
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
-    /**
-     * Captura la instancia de echarts (usado por ngx-echarts)
-     */
-    onChartInit(instance: any): void;
-    /**
-     * Configura interacciones base como el clic en el fondo para limpiar selección.
-     */
-    private setupBaseInteractions;
-    onChartClick(event: any): void;
-    /**
-     * Maneja la lógica de alternancia de selección.
-     */
-    protected handleSelection(dataIndex: number, seriesIndex: number): void;
-    /**
-     * Limpia el estado de selección actual.
-     */
-    protected clearSelection(): void;
-    dispatchAction(type: string, d: {
+    /** setear/actualizar opciones del chart
+     *
+     * Ver: https://echarts.apache.org/en/api.html#echartsInstance.setOption
+    */
+    private setOptions;
+    protected dispatchAction(type: string, d: {
         seriesIndex?: number[];
         dataIndex?: number[];
     }): void;
-    /**
-   * Maneja clics en la leyenda para persistir filtros.
-   */
-    onLegendSelectChanged(event: any): void;
-    private updateOptions;
     /**
      * Hook de template method invocado por `ngOnChanges`.
      * Las subclases lo sobreescriben para añadir lógica propia
@@ -250,16 +250,26 @@ declare abstract class BaseEchartsComponent implements OnChanges, OnDestroy {
      * el comportamiento base (detectar inputs relevantes y actualizar el chart).
      */
     protected onInputChanges(changes: SimpleChanges): void;
-    protected abstract updateChartOptions(opts?: {
-        notMerge?: boolean;
-    }): void;
     /**
-   * Gatilla actualización en ngx-echarts
+   * Gatilla actualización.
+   *
    */
-    protected triggerUpdate(options: echarts.EChartsOption): void;
+    protected triggerUpdate(options: EChartsOption): void;
     /**
-     * Método público para forzar el redimensionado desde el padre
+     * Captura la instancia de echarts (usado por ngx-echarts)
+     */
+    onChartInit(instance: any): void;
+    onChartClick(event: any): void;
+    /**
+     * Seleccion y des seleccion de item.
+     *
+     * Para hacer uso de esta funcion las opciones de series
+     * del grafico deben tener seteado 'selectMode'.
      */
+    onChartSelectChanged(event: NGXEchartsSelectChangeEventData): void;
+    /**
+   * Método público para forzar el redimensionado desde el padre
+   */
     resize(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<BaseEchartsComponent, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<BaseEchartsComponent, never, never, { "data": { "alias": "data"; "required": false; }; "optionsOverrides": { "alias": "optionsOverrides"; "required": false; }; "palette": { "alias": "palette"; "required": false; }; "colorResolver": { "alias": "colorResolver"; "required": false; }; "valueFormatter": { "alias": "valueFormatter"; "required": false; }; }, { "chartClick": "chartClick"; }, never, never, true, never>;
@@ -326,17 +336,12 @@ declare class EchartsRingComponent extends BaseEchartsComponent {
     onChartClick(event: any): void;
     onChartMouseOver(event: any): void;
     onChartMouseOut(event: any): void;
-    /**
-     * Captura los cambios en la selección de la leyenda para persistirlos.
-     */
-    onLegendSelectChanged(event: any): void;
+    onChartSelectChangedParcheado(e: NGXEchartsSelectChangeEventData): void;
     /**
      * Actualiza el texto del Graphic central y persiste la selección en el modelo de opciones.
      */
     private setGraphicText;
-    protected updateChartOptions(opts?: {
-        notMerge?: boolean;
-    }): void;
+    protected updateChartOptions(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EchartsRingComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EchartsRingComponent, "vs-echarts-ring", never, {}, {}, never, never, true, never>;
 }
@@ -422,12 +427,6 @@ declare abstract class EchartsBarComponent extends BaseEchartsComponent {
     constructor();
     protected make(makeOpts: MakeBarOpts): void;
     protected updateChartOptions(): void;
-    onChartInit(instance: any): void;
-    protected onInputChanges(changes: SimpleChanges): void;
-    private setupAdditionalInteractions;
-    private highlightSector;
-    private clearHighlight;
-    onLegendSelectChanged(event: any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EchartsBarComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EchartsBarComponent, "vs-echarts-bar", never, {}, {}, never, never, true, never>;
 }
@@ -482,7 +481,6 @@ declare abstract class EchartsLineComponent extends BaseEchartsComponent {
     */
     protected abstract variantBaseProduct: VSEChartProduct;
     constructor();
-    protected onInputChanges(changes: SimpleChanges): void;
     protected make(makeOpts: MakeLineOpts): void;
     protected updateChartOptions(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EchartsLineComponent, never>;
@@ -508,4 +506,4 @@ declare class EChartsAreaStackComponent extends EchartsLineComponent {
 }
 
 export { BaseEchartsComponent, EChartsAreaComponent, EChartsAreaStackComponent, EChartsBarStackedComponent, EChartsBarStackedRadialComponent, EChartsHBarComponent, EChartsHBarStackedComponent, EchartsBarComponent, EchartsLineComponent, EchartsRingComponent, defaultOptionsOverrides, initializeEcharts, provideVSEcharts };
-export type { ChartColorResolver, ChartOrientation, EChartClickType, EChartValueFormatter, IAreaOptionsOverrides, IAreaStackOptionsOverrides, IAxisOptionsOverrides, IBarOptionsOverrides, IBarStackedOptionsOverrides, IBarStackedRadialOptionsOverrides, IEChartBuilder, IEChartData, IEChartSeries, IHBarOptionsOverrides, IHBarStackedOptionsOverrides, ILineOptionsOverrides, IOptionsOverrides, IOptionsOverridesWrapper, IRingOptionsOverrides, ITooltipOptionsOverrides, VSEChartProduct };
+export type { ChartColorResolver, ChartOrientation, EChartClickType, EChartValueFormatter, IAreaOptionsOverrides, IAreaStackOptionsOverrides, IAxisOptionsOverrides, IBarOptionsOverrides, IBarStackedOptionsOverrides, IBarStackedRadialOptionsOverrides, IEChartBuilder, IEChartData, IEChartSeries, IHBarOptionsOverrides, IHBarStackedOptionsOverrides, ILineOptionsOverrides, IOptionsOverrides, IOptionsOverridesWrapper, IRingOptionsOverrides, ITooltipOptionsOverrides, NGXEchartsSelectChangeEventData, VSEChartProduct };

package/package.json

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