@visionaris-bruno/vs-echarts 9.1.0 → 9.2.0

package/index.d.ts

@@ -5,6 +5,7 @@ import { LineSeriesOption, BarSeriesOption, PieSeriesOption, ScatterSeriesOption
 import { CategoryAxisBaseOption, ValueAxisBaseOption } from 'echarts/types/src/coord/axisCommonTypes.js';
 import { TooltipOption } from 'echarts/types/dist/shared';
 import * as _visionaris_bruno_vs_echarts from '@visionaris-bruno/vs-echarts';
+import { TranslateService } from '@ngx-translate/core';
 
 type ChartKey = keyof Omit<IOptionsOverridesWrapper, "axis" | "tooltip">;
 type ISeriesLayoutOpts = {
@@ -21,7 +22,7 @@ type VSEChartProduct = {
     chartKey: ChartKey;
     baseOptions: EChartsOption;
 };
-interface IEChartBuilder<SeriesType = SeriesOption, SeriesConfigOptions = any, DatasetConfigOptions = any> {
+interface IEChartBuilder<SeriesType = SeriesOption, SeriesConfigOptions = any, DatasetConfigOptions = any, DataZoomConfigOptions = any> {
     /** producto base */
     baseProduct: VSEChartProduct;
     reset(): void;
@@ -36,7 +37,7 @@ interface IEChartBuilder<SeriesType = SeriesOption, SeriesConfigOptions = any, D
     addLegend(): void;
     addCommons(): void;
     addGraphic(): void;
-    addDataZoom(): void;
+    addDataZoom(opts?: DataZoomConfigOptions): void;
     setValueFormatter(formatter: ChartValueFormatter): void;
     setPalette(palette: string[]): void;
     setColorResolver(resolver: ChartColorResolver): void;
@@ -122,7 +123,7 @@ interface IOptionsOverrides {
     /** sankey options overrides */
     sankey: ISankeyOptionsOverrides;
     /** boxplot options overrides */
-    hBoxplot: IHBoxplotOptionsOverrides;
+    boxplot: IBoxplotOptionsOverrides;
     /** heatmap calendar options overrides */
     heatmapCalendar: IHeatmapCalendarOptionsOverrides;
 }
@@ -178,7 +179,7 @@ interface IEChartData {
  *
  * Callback para formatear los valores numéricos de las celdas/series.
  */
-type ChartValueFormatter = (value: number, key: string) => string;
+type ChartValueFormatter = (value: number, key?: string) => string;
 /**
  * ChartColorResolver
  *
@@ -207,6 +208,8 @@ interface IOptionsOverridesWrapper extends IOptionsOverrides {
 declare function provideVSEcharts(): i0.Provider;
 declare function defaultOptionsOverrides(): IOptionsOverridesWrapper;
 
+declare function getActiveLocale(): VSEchartsLocale | undefined;
+declare function setActiveLocale(locale: VSEchartsLocale | undefined): void;
 declare class VSEchartsConfigService {
     private vsEchartsConfig;
     private readonly mapping;
@@ -763,12 +766,65 @@ declare class EchartsSankeyComponent extends BaseEchartsComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<EchartsSankeyComponent, "vs-echarts-sankey", never, {}, {}, never, never, true, never>;
 }
 
-declare class EChartsHBoxplotComponent extends BaseEchartsComponent {
+declare class EChartsBoxplotComponent extends BaseEchartsComponent {
     protected baseSeriesOptions: BoxplotSeriesOption;
     protected baseProduct: VSEChartProduct;
     protected builder: IEChartBuilder<BoxplotSeriesOption>;
     protected director: VSECDirector;
     protected make(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EChartsBoxplotComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EChartsBoxplotComponent, "vs-echarts-boxplot", never, {}, {}, never, never, true, never>;
+}
+
+type BoxplotBuilderDatasetConfigOpts = {};
+type BoxplotBuilderSeriesConfigOpts = Pick<ISeriesLayoutOpts, 'axisTypes'> & {};
+type BoxplotBuilderDataZoomConfigOpts = {
+    axisTypes: {
+        x: 'value' | 'category';
+        y: 'category' | 'value';
+    };
+};
+declare class BoxplotBuilder implements IEChartBuilder<BoxplotSeriesOption, BoxplotBuilderSeriesConfigOpts, BoxplotBuilderDatasetConfigOpts, BoxplotBuilderDataZoomConfigOpts> {
+    baseProduct: VSEChartProduct;
+    protected translateService?: TranslateService;
+    protected valueFormatter: ChartValueFormatter;
+    protected palette: string[];
+    protected colorResolver?: ChartColorResolver;
+    protected result: EChartsOption;
+    constructor(baseProduct: VSEChartProduct);
+    reset(): void;
+    addDataset(data: IEChartData, opts?: BoxplotBuilderDatasetConfigOpts): void;
+    addCommons(): void;
+    addSeries(data: IEChartData, overrides: BoxplotSeriesOption, opts?: any): void;
+    addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
+    addDataZoom(opts?: BoxplotBuilderDataZoomConfigOpts): void;
+    addXAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type?: "category" | "value"): void;
+    addYAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type?: "category" | "value"): void;
+    addRadiusAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
+    addAngleAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
+    addLegend(): void;
+    addGraphic(): void;
+    addPolar(): void;
+    /**
+     * Permite inyectar un formateador de valores externo.
+     */
+    setValueFormatter(formatter: ChartValueFormatter | undefined): void;
+    /**
+     * Permite inyectar una paleta de colores básica.
+     */
+    setPalette(palette: string[] | undefined): void;
+    /**
+     * Permite inyectar un resolver de colores dinámico.
+     */
+    setColorResolver(resolver: ChartColorResolver | undefined): void;
+    getResult(): EChartsOption;
+}
+
+declare class EChartsHBoxplotComponent extends EChartsBoxplotComponent {
+    protected baseProduct: VSEChartProduct;
+    protected builder: BoxplotBuilder;
+    protected director: VSECDirector;
+    protected make(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EChartsHBoxplotComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EChartsHBoxplotComponent, "vs-echarts-hboxplot", never, {}, {}, never, never, true, never>;
 }
@@ -787,5 +843,5 @@ declare class EChartsHeatmapCalendar extends BaseEchartsComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<EChartsHeatmapCalendar, "vs-echarts-heatmapCalendar", never, {}, {}, never, never, true, never>;
 }
 
-export { BaseEchartsComponent, EChartsAreaComponent, EChartsAreaStackComponent, EChartsBarStackedComponent, EChartsBarStackedRadialComponent, EChartsHBarComponent, EChartsHBarStackedComponent, EChartsHBoxplotComponent, EChartsHeatmapCalendar, EChartsSunburstComponent, EchartsBarComponent, EchartsFunnelComponent, EchartsLineComponent, EchartsPieComponent, EchartsRingComponent, EchartsSankeyComponent, EchartsScatterComponent, VSEchartsConfigService, defaultOptionsOverrides, provideVSEcharts };
+export { BaseEchartsComponent, EChartsAreaComponent, EChartsAreaStackComponent, EChartsBarStackedComponent, EChartsBarStackedRadialComponent, EChartsBoxplotComponent, EChartsHBarComponent, EChartsHBarStackedComponent, EChartsHBoxplotComponent, EChartsHeatmapCalendar, EChartsSunburstComponent, EchartsBarComponent, EchartsFunnelComponent, EchartsLineComponent, EchartsPieComponent, EchartsRingComponent, EchartsSankeyComponent, EchartsScatterComponent, VSEchartsConfigService, defaultOptionsOverrides, getActiveLocale, provideVSEcharts, setActiveLocale };
 export type { ChartColorResolver, ChartOrientation, ChartValueFormatter, EChartClickType, IAreaOptionsOverrides, IAreaStackOptionsOverrides, IAxisOptionsOverrides, IBarOptionsOverrides, IBarStackedOptionsOverrides, IBarStackedRadialOptionsOverrides, IBoxplotOptionsOverrides, IEChartBuilder, IEChartData, IEChartDataNode, IEChartDimension, IFunnelOptionsOverrides, IHBarOptionsOverrides, IHBarStackedOptionsOverrides, IHBoxplotOptionsOverrides, IHeatmapCalendarOptionsOverrides, ILineOptionsOverrides, IOptionsOverrides, IOptionsOverridesWrapper, IPieOptionsOverrides, IRingOptionsOverrides, ISankeyOptionsOverrides, IScatterOptionsOverrides, ISeriesLayoutOpts, ISunburstOptionsOverrides, ITooltipOptionsOverrides, NGXEchartsSelectChangeEventData, VSEChartProduct, VSEchartsConfig, VSEchartsLocale };

package/package.json

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