@visionaris-bruno/vs-echarts 8.4.2 → 8.6.0

package/index.d.ts

@@ -1,18 +1,19 @@
-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, SunburstSeriesOption, SankeySeriesOption, BoxplotSeriesOption, EChartsOption, SeriesOption } from 'echarts';
 import { CategoryAxisBaseOption, ValueAxisBaseOption } from 'echarts/types/src/coord/axisCommonTypes.js';
 import { TooltipOption } from 'echarts/types/dist/shared';
+import * as i0 from '@angular/core';
+import { OnChanges, OnDestroy, ElementRef, EventEmitter, SimpleChanges } from '@angular/core';
+import * as _visionaris_bruno_vs_echarts from '@visionaris-bruno/vs-echarts';
 
-type ChartKey = keyof Omit<IOptionsOverridesWrapper, "axis" | "tooltip">;
-type ISeriesLayoutOpts = {
+interface ISeriesLayoutOpts {
     coordinateSystem?: 'cartesian2d' | 'polar';
     axisTypes?: {
         x: 'category' | 'value';
         y: 'category' | 'value';
     };
-};
+}
+type ChartKey = keyof Omit<IOptionsOverridesWrapper, "axis" | "tooltip">;
 /** los recibira el director
  *
  */
@@ -20,12 +21,12 @@ type VSEChartProduct = {
     chartKey: ChartKey;
     baseOptions: EChartsOption;
 };
-interface IEChartBuilder<SeriesType = SeriesOption, SeriesConfigOptions = any, DatasetConfigOptions = any> {
+interface IEChartBuilder<SeriesType = SeriesOption, OptsType = any, DatasetConfigOptions = any> {
     /** producto base */
     baseProduct: VSEChartProduct;
     reset(): void;
     addDataset(data: IEChartData, opts?: DatasetConfigOptions): void;
-    addSeries(data: IEChartData, overrides: SeriesType, opts?: SeriesConfigOptions): void;
+    addSeries(data: IEChartData, overrides: SeriesType, opts?: OptsType): void;
     addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
     addPolar(): void;
     addXAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type?: 'category' | 'value'): void;
@@ -36,9 +37,9 @@ interface IEChartBuilder<SeriesType = SeriesOption, SeriesConfigOptions = any, D
     addCommons(): void;
     addGraphic(): void;
     addDataZoom(): void;
-    setValueFormatter(formatter: EChartValueFormatter): void;
-    setPalette(palette: string[]): void;
-    setColorResolver(resolver: ChartColorResolver): void;
+    setValueFormatter(formatter: EChartValueFormatter | undefined): void;
+    setPalette(palette: string[] | undefined): void;
+    setColorResolver(resolver: ChartColorResolver | undefined): void;
     getResult(): EChartsOption;
 }
 type EChartClickType = 'cross-filter';
@@ -137,13 +138,11 @@ type NGXEchartsSelectChangeEventData = {
     }[];
     escapeConnect: unknown;
 };
-type BoxplotStatisticsKeys = {
-    min: string;
-    q1: string;
-    median: string;
-    q3: string;
-    max: string;
-};
+type VSEchartsLocale = 'ZH' | 'EN' | 'AR' | 'CS' | 'DE' | 'EL' | 'ES' | 'FA' | 'FI' | 'FR' | 'HU' | 'IT' | 'JA' | 'KO' | 'LV' | 'nb-NO' | 'NL' | 'PL' | 'PT-br' | 'RO' | 'RU' | 'SI' | 'SV' | 'TH' | 'TR' | 'UK' | 'VI';
+interface VSEchartsConfig {
+    renderer?: 'canvas' | 'svg';
+    locale?: VSEchartsLocale;
+}
 
 /**
  * IEChartDataNode
@@ -196,14 +195,17 @@ interface IOptionsOverridesWrapper extends IOptionsOverrides {
     hBoxplot: IHBoxplotOptionsOverrides;
 }
 
-declare function initializeEcharts(): void;
-/**
- * Provee la configuración de ECharts para ngx-echarts.
- * Llama automáticamente a la inicialización de módulos.
- */
-declare function provideVSEcharts(): i0.Provider;
 declare function defaultOptionsOverrides(): IOptionsOverridesWrapper;
 
+declare class VSEchartsConfigService {
+    private vsEchartsConfig;
+    private readonly mapping;
+    constructor(vsEchartsConfig: VSEchartsConfig);
+    setLocale(language: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VSEchartsConfigService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<VSEchartsConfigService>;
+}
+
 type MakeOpts = {
     valueFormatter?: EChartValueFormatter;
     palette?: string[];
@@ -216,15 +218,13 @@ type MakeOpts = {
 type MakeBarOpts = MakeOpts;
 type MakeLineOpts = MakeOpts;
 type MakeScatterOpts = MakeOpts;
-type MakeBoxplotOpts = MakeOpts & {
-    statisticsKeys?: BoxplotStatisticsKeys;
-};
+type MakeBoxplotOpts = MakeOpts & {};
 /**
  * Director de Builds.
  */
 declare class VSECDirector {
     private builder;
-    constructor(builder: IEChartBuilder);
+    constructor(builder: IEChartBuilder<any, ISeriesLayoutOpts>);
     makeBar(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeBarOpts): void;
     makeBarRadial(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeBarOpts): void;
     makeLine(data: IEChartData, overrides: IOptionsOverridesWrapper, opts?: MakeLineOpts): void;
@@ -243,11 +243,11 @@ declare abstract class BaseEchartsComponent implements OnChanges, OnDestroy {
     data: IEChartData;
     optionsOverrides: IOptionsOverridesWrapper;
     /** Paleta de colores básica */
-    palette: string[];
+    palette?: string[];
     /** Resolver de colores dinámico (Callback) */
     colorResolver?: ChartColorResolver;
     /** Formateador de valores para etiquetas y tooltips */
-    valueFormatter: EChartValueFormatter;
+    valueFormatter?: EChartValueFormatter;
     chartClick: EventEmitter<{
         type: EChartClickType;
         data: any;
@@ -276,12 +276,14 @@ declare abstract class BaseEchartsComponent implements OnChanges, OnDestroy {
      */
     protected abstract baseSeriesOptions: SeriesOption;
     protected chartInstance?: echarts.ECharts;
+    protected vsEchartsConfig: _visionaris_bruno_vs_echarts.VSEchartsConfig | null;
     /** Opciones de inicializacion de echarts
      *
      * NgxEchartsDirective.initOpts
      */
     initOptions: {
-        renderer: string;
+        renderer: "canvas" | "svg";
+        locale: _visionaris_bruno_vs_echarts.VSEchartsLocale | undefined;
     };
     constructor();
     ngOnChanges(changes: SimpleChanges): void;
@@ -359,9 +361,9 @@ declare class RingBuilder implements IEChartBuilder<PieSeriesOption> {
     addAngleAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
     addDataZoom(): void;
     addDataset(data: IEChartData, opts?: any): void;
-    setValueFormatter(formatter: EChartValueFormatter): void;
-    setPalette(palette: string[]): void;
-    setColorResolver(resolver: ChartColorResolver): void;
+    setValueFormatter(formatter: EChartValueFormatter | undefined): void;
+    setPalette(palette: string[] | undefined): void;
+    setColorResolver(resolver: ChartColorResolver | undefined): void;
     getResult(): EChartsOption;
     private formatCellValue;
 }
@@ -425,9 +427,9 @@ declare class PieBuilder implements IEChartBuilder<PieSeriesOption> {
     addGraphic(): void;
     addDataZoom(): void;
     addDataset(data: IEChartData, opts?: any): void;
-    setValueFormatter(formatter: EChartValueFormatter): void;
-    setPalette(palette: string[]): void;
-    setColorResolver(resolver: ChartColorResolver): void;
+    setValueFormatter(formatter: EChartValueFormatter | undefined): void;
+    setPalette(palette: string[] | undefined): void;
+    setColorResolver(resolver: ChartColorResolver | undefined): void;
     getResult(): EChartsOption;
     private formatCellValue;
 }
@@ -498,7 +500,6 @@ declare class EchartsFunnelComponent extends BaseEchartsComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<EchartsFunnelComponent, "vs-echarts-funnel", never, {}, {}, never, never, true, never>;
 }
 
-type EChartBuilderSeriesConfigOpts = ISeriesLayoutOpts & {};
 /**
  * Builder principal.
  *
@@ -506,7 +507,7 @@ type EChartBuilderSeriesConfigOpts = ISeriesLayoutOpts & {};
  *
  * Puede verse utilizado en graficos como Lineas y Bars. Siempre que se pueda priorizar utilizar este.
  */
-declare class EChartBuilder implements IEChartBuilder<SeriesOption & BarSeriesOption & LineSeriesOption & ScatterSeriesOption, EChartBuilderSeriesConfigOpts> {
+declare class EChartBuilder implements IEChartBuilder<SeriesOption & BarSeriesOption & LineSeriesOption & ScatterSeriesOption, ISeriesLayoutOpts> {
     baseProduct: VSEChartProduct;
     protected valueFormatter: EChartValueFormatter;
     protected palette: string[];
@@ -521,7 +522,7 @@ declare class EChartBuilder implements IEChartBuilder<SeriesOption & BarSeriesOp
      * @param overrides
      * @returns
      */
-    addSeries(data: IEChartData, overrides: BarSeriesOption & LineSeriesOption & ScatterSeriesOption, opts?: ISeriesLayoutOpts): void;
+    addSeries(data: IEChartData, overrides: SeriesOption & BarSeriesOption & LineSeriesOption & ScatterSeriesOption, opts?: ISeriesLayoutOpts): void;
     /**
      * TODO: Mejorar funcion, no me convence como se implemento el tooltip formatter.
      * @param data
@@ -535,7 +536,7 @@ declare class EChartBuilder implements IEChartBuilder<SeriesOption & BarSeriesOp
     addAngleAxis(data: IEChartData, overrides: IOptionsOverrides["axis"]): void;
     addLegend(): void;
     addGraphic(): void;
-    addDataset(data: IEChartData): void;
+    addDataset(data: IEChartData, opts?: any): void;
     addDataZoom(): void;
     getResult(): EChartsOption;
     /**
@@ -554,8 +555,8 @@ declare class EChartBuilder implements IEChartBuilder<SeriesOption & BarSeriesOp
      * Permite inyectar un resolver de colores dinámico.
      */
     setColorResolver(resolver: ChartColorResolver): void;
-    private getCategoryAxisOptions;
-    private getValueAxisOptions;
+    protected getCategoryAxisOptions(data: IEChartData, overrides: IOptionsOverrides["axis"]): CategoryAxisBaseOption;
+    protected getValueAxisOptions(data: IEChartData, overrides: IOptionsOverrides["axis"]): any;
 }
 
 declare abstract class EchartsBarComponent extends BaseEchartsComponent {
@@ -680,6 +681,7 @@ declare class SunburstBuilder implements IEChartBuilder<SunburstSeriesOption> {
     addSeries(data: IEChartData, overrides: SunburstSeriesOption): void;
     addTooltip(data: IEChartData, overrides: ITooltipOptionsOverrides): void;
     addCommons(): void;
+    addGraphic(): void;
     getResult(): EChartsOption;
     addPolar(): void;
     addXAxis(data: IEChartData, overrides: IOptionsOverrides["axis"], type: "category" | "value"): void;
@@ -689,7 +691,6 @@ declare class SunburstBuilder implements IEChartBuilder<SunburstSeriesOption> {
     addLegend(): void;
     addDataZoom(): void;
     addDataset(data: IEChartData, opts?: any): void;
-    addGraphic(): void;
     /**
      * Permite inyectar un formateador de valores externo.
      */
@@ -740,9 +741,9 @@ declare class SankeyBuilder implements IEChartBuilder<SankeySeriesOption> {
     addCommons(): void;
     addGraphic(): void;
     getResult(): EChartsOption;
-    setValueFormatter(formatter: EChartValueFormatter): void;
-    setPalette(palette: string[]): void;
-    setColorResolver(resolver: ChartColorResolver): void;
+    setValueFormatter(formatter: EChartValueFormatter | undefined): void;
+    setPalette(palette: string[] | undefined): void;
+    setColorResolver(resolver: ChartColorResolver | undefined): void;
 }
 
 declare class EchartsSankeyComponent extends BaseEchartsComponent {
@@ -765,5 +766,5 @@ declare class EChartsHBoxplotComponent extends BaseEchartsComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<EChartsHBoxplotComponent, "vs-echarts-hboxplot", never, {}, {}, never, never, true, never>;
 }
 
-export { BaseEchartsComponent, EChartsAreaComponent, EChartsAreaStackComponent, EChartsBarStackedComponent, EChartsBarStackedRadialComponent, EChartsHBarComponent, EChartsHBarStackedComponent, EChartsHBoxplotComponent, EChartsSunburstComponent, EchartsBarComponent, EchartsFunnelComponent, EchartsLineComponent, EchartsPieComponent, EchartsRingComponent, EchartsSankeyComponent, EchartsScatterComponent, defaultOptionsOverrides, initializeEcharts, provideVSEcharts };
-export type { BoxplotStatisticsKeys, ChartColorResolver, ChartOrientation, EChartClickType, EChartValueFormatter, IAreaOptionsOverrides, IAreaStackOptionsOverrides, IAxisOptionsOverrides, IBarOptionsOverrides, IBarStackedOptionsOverrides, IBarStackedRadialOptionsOverrides, IBoxplotOptionsOverrides, IEChartBuilder, IEChartData, IEChartDataNode, IEChartDimension, IFunnelOptionsOverrides, IHBarOptionsOverrides, IHBarStackedOptionsOverrides, IHBoxplotOptionsOverrides, ILineOptionsOverrides, IOptionsOverrides, IOptionsOverridesWrapper, IPieOptionsOverrides, IRingOptionsOverrides, ISankeyOptionsOverrides, IScatterOptionsOverrides, ISeriesLayoutOpts, ISunburstOptionsOverrides, ITooltipOptionsOverrides, NGXEchartsSelectChangeEventData, VSEChartProduct };
+export { BaseEchartsComponent, EChartsAreaComponent, EChartsAreaStackComponent, EChartsBarStackedComponent, EChartsBarStackedRadialComponent, EChartsHBarComponent, EChartsHBarStackedComponent, EChartsHBoxplotComponent, EChartsSunburstComponent, EchartsBarComponent, EchartsFunnelComponent, EchartsLineComponent, EchartsPieComponent, EchartsRingComponent, EchartsSankeyComponent, EchartsScatterComponent, VSEchartsConfigService, defaultOptionsOverrides };
+export type { ChartColorResolver, ChartOrientation, EChartClickType, EChartValueFormatter, IAreaOptionsOverrides, IAreaStackOptionsOverrides, IAxisOptionsOverrides, IBarOptionsOverrides, IBarStackedOptionsOverrides, IBarStackedRadialOptionsOverrides, IBoxplotOptionsOverrides, IEChartBuilder, IEChartData, IEChartDataNode, IEChartDimension, IFunnelOptionsOverrides, IHBarOptionsOverrides, IHBarStackedOptionsOverrides, IHBoxplotOptionsOverrides, ILineOptionsOverrides, IOptionsOverrides, IOptionsOverridesWrapper, IPieOptionsOverrides, IRingOptionsOverrides, ISankeyOptionsOverrides, IScatterOptionsOverrides, ISeriesLayoutOpts, ISunburstOptionsOverrides, ITooltipOptionsOverrides, NGXEchartsSelectChangeEventData, VSEChartProduct, VSEchartsConfig, VSEchartsLocale };

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@visionaris-bruno/vs-echarts",
-  "version": "8.4.2",
+  "version": "8.6.0",
   "peerDependencies": {
     "@angular/common": "^20.3.0",
     "@angular/core": "^20.3.0",
+    "@ngx-translate/core": "^15.0.0",
     "echarts": "^6.0.0",
     "lodash": "^4.17.21",
     "ngx-echarts": "^20.0.1",