@visionaris-bruno/vs-echarts 6.1.2 → 6.3.0

package/index.d.ts

@@ -1,9 +1,9 @@
 import * as i0 from '@angular/core';
 import { OnChanges, OnDestroy, ElementRef, EventEmitter, SimpleChanges } from '@angular/core';
 import * as echarts from 'echarts';
-import { LineSeriesOption, BarSeriesOption, PieSeriesOption, EChartsOption, SeriesOption } from 'echarts';
+import { LineSeriesOption, BarSeriesOption, PieSeriesOption, ScatterSeriesOption, 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
@@ -17,7 +17,7 @@ interface IEChartBuilder {
     /** producto base */
     baseProduct: VSEChartProduct;
     reset(): void;
-    addSeries(data: IEChartData, overrides: SeriesOption & BarSeriesOption & LineSeriesOption): void;
+    addSeries(data: IEChartData, overrides: SeriesOption & BarSeriesOption & LineSeriesOption & ScatterSeriesOption): void;
     addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
     addPolar(): void;
     addXAxis(data: {
@@ -61,6 +61,9 @@ interface IBarOptionsOverrides {
 interface IRingOptionsOverrides {
     series?: Partial<PieSeriesOption>;
 }
+interface IScatterOptionsOverrides {
+    series?: Partial<ScatterSeriesOption>;
+}
 interface IAxisOptionsOverrides {
     categoryAxis: CategoryAxisBaseOption[];
     valueAxis: ValueAxisBaseOption[];
@@ -81,7 +84,26 @@ interface IOptionsOverrides {
     bar: IBarOptionsOverrides;
     /** ring options overrides */
     ring: IRingOptionsOverrides;
+    /** scatter options overrides */
+    scatter: IScatterOptionsOverrides;
 }
+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
@@ -149,6 +171,7 @@ type MakeOpts = {
 };
 type MakeBarOpts = MakeOpts;
 type MakeLineOpts = MakeOpts;
+type MakeScatterOpts = MakeOpts;
 /**
  * Director de Builds.
  */
@@ -158,6 +181,7 @@ declare class VSECDirector {
     makeBar(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeBarOpts): void;
     makeBarRadial(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeBarOpts): void;
     makeLine(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeLineOpts): void;
+    makeScatter(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeScatterOpts): void;
     makeRing(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeOpts): void;
 }
 
@@ -199,11 +223,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 +238,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 +257,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 +343,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>;
 }
@@ -363,7 +375,7 @@ declare class EChartBuilder implements IEChartBuilder {
      * @param overrides
      * @returns
      */
-    addSeries(data: IEChartData, overrides: SeriesOption & BarSeriesOption & LineSeriesOption): void;
+    addSeries(data: IEChartData, overrides: SeriesOption & BarSeriesOption & LineSeriesOption & ScatterSeriesOption): void;
     /**
      * TODO: Mejorar funcion, no me convence como se implemento el tooltip formatter.
      * @param data
@@ -422,12 +434,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 +488,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>;
@@ -507,5 +512,25 @@ declare class EChartsAreaStackComponent extends EchartsLineComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<EChartsAreaStackComponent, "vs-echarts-bar", never, {}, {}, never, never, true, never>;
 }
 
-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 };
+declare abstract class EchartsScatterComponent extends BaseEchartsComponent {
+    /**
+     * Opciones esenciales inmutables estáticas comunes a todos los charts de dispersión.
+     */
+    protected baseSeriesOptions: ScatterSeriesOption;
+    /** variante de producto base/inicial para el builder.
+     *
+     * Utilizar para crear una variante (extender) un base producto.
+     */
+    protected abstract variantBaseProduct: VSEChartProduct;
+    protected baseProduct: VSEChartProduct;
+    protected builder: EChartBuilder;
+    protected director: VSECDirector;
+    constructor();
+    protected make(makeOpts: MakeScatterOpts): void;
+    protected updateChartOptions(): 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, EchartsLineComponent, EchartsRingComponent, EchartsScatterComponent, defaultOptionsOverrides, initializeEcharts, provideVSEcharts };
+export type { ChartColorResolver, ChartOrientation, EChartClickType, EChartValueFormatter, IAreaOptionsOverrides, IAreaStackOptionsOverrides, IAxisOptionsOverrides, IBarOptionsOverrides, IBarStackedOptionsOverrides, IBarStackedRadialOptionsOverrides, IEChartBuilder, IEChartData, IEChartSeries, IHBarOptionsOverrides, IHBarStackedOptionsOverrides, ILineOptionsOverrides, IOptionsOverrides, IOptionsOverridesWrapper, IRingOptionsOverrides, IScatterOptionsOverrides, ITooltipOptionsOverrides, NGXEchartsSelectChangeEventData, VSEChartProduct };

package/package.json

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