stz-chart-maker 2.3.2 → 2.3.4

package/README.md

@@ -64,7 +64,14 @@ import { setChartConfig } from 'stz-chart-maker';
 setChartConfig({
   errorLogging: true,
   silentMode: false,
-  defaultColor: ['#FF6B6B', '#4ECDC4', '#45B7D1', '#FFA07A', '#98D8C8', '#F7DC6F']
+  defaultColor: ['#FF6B6B', '#4ECDC4', '#45B7D1', '#FFA07A', '#98D8C8', '#F7DC6F'],
+  zoom: true,
+  legend: {
+    position: 'top'
+  },
+  tooltip: {
+    enabled: true
+  }
 });
 ```
 
@@ -86,6 +93,12 @@ module.exports = {
 | `errorLogging` | `boolean` | `true` | 에러 로그 출력 여부 |
 | `silentMode` | `boolean` | `true` | 에러 발생 시 예외를 던지지 않고 처리 |
 | `defaultColor` | `string[]` | 내부 기본 팔레트 | 차트 전역 기본 색상 배열 |
+| `zoom` | `boolean \| object` | `false` | `line`, `bar`, `bubble` 차트에 전역 zoom 기본값 적용 |
+| `legend` | `object` | 차트 기본값 사용 | 차트 전역 legend 기본 옵션 적용 |
+| `tooltip` | `object` | 차트 기본값 사용 | 차트 전역 tooltip 기본 옵션 적용 |
+
+### 변경기록
+[CHANGELOG.md](./CHANGELOG.md) 파일을 참조하세요.
 
 ### 주의사항
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ChartTypeRegistry, ChartType, ChartDataset, GridLineOptions, FontSpec, Tick, PluginOptionsByType, Chart as Chart$1, ChartOptions, ChartEvent, ActiveElement, LegendOptions, Plugin as Plugin$1, TooltipItem } from 'chart.js';
+import { ChartTypeRegistry, ChartType, ChartDataset, GridLineOptions, FontSpec, Tick, PluginOptionsByType, Chart as Chart$1, ChartOptions, ChartEvent, ActiveElement, LegendOptions, TooltipOptions, Plugin as Plugin$1, TooltipItem } from 'chart.js';
 import { TreemapControllerDatasetOptions } from 'chartjs-chart-treemap';
 import { ZoomPluginOptions } from 'chartjs-plugin-zoom/types/options';
 
@@ -494,6 +494,7 @@ interface ChartBuilder<TType extends ChartType> {
     }) => void): this;
     setTitle(titleOptions: CommonCartesianTitleConfig): this;
     setLegend(legendOptions: DeepPartial<LegendOptions<any>>): this;
+    setTooltip(tooltipOptions: DeepPartial<TooltipOptions<any>>): this;
     mergeOptions(options: DeepPartial<CustomChartOptions<TType>>): this;
     getChartData(uid: string): CustomChartDatasets<TType>;
     setChartData(uid: string, data: CustomChartDatasets<TType>): void;
@@ -515,6 +516,7 @@ interface CartesianChartBuilder<TType extends CartesianChartType> extends ChartB
         color?: string;
         lineWidth?: number;
     }): this;
+    setZoom(enabled: boolean, zoomOption?: DeepPartialZoomType): this;
     addZoom(defaultZoom?: boolean, zoomOption?: object): this;
     addDataLabels(defultDataLabels?: boolean, dataLabelsOptions?: PartialDataLabels): this;
     setYAxisForDataset(datasetIndex: number, axisId?: string): this;
@@ -731,6 +733,7 @@ declare abstract class Chart<TType extends ChartType, TOptions extends CustomCha
     static has(type: ChartType): boolean;
     protected cloneValue<T>(value: T): T;
     protected clonePlugins<TPlugins>(plugins: TPlugins): TPlugins;
+    protected applyGlobalPluginConfig(): void;
     protected requireDatasets(): CustomChartDatasets<TType>[];
     protected resolveDatasetIndex(uidOrIndex: string | number): number;
     protected getDatasetByTarget(uidOrIndex: string | number): CustomChartDatasets<TType>;
@@ -826,6 +829,20 @@ declare abstract class Chart<TType extends ChartType, TOptions extends CustomCha
      * });
      */
     setLegend(legendOptions: DeepPartial<LegendOptions<TType>>): this;
+    /**
+     * @description 차트의 툴팁을 설정합니다.
+     * 전역 `setChartConfig({ tooltip: ... })` 설정이 있으면 이를 기본값으로 사용하고, 이 메서드 호출값으로 병합합니다.
+     * @param {DeepPartial<TooltipOptions<TType>>} tooltipOptions
+     * @returns {this}
+     * @Since 2.4.0
+     * @category options
+     * @example
+     * chart.setTooltip({
+     *   enabled: true,
+     *   backgroundColor: 'rgba(8, 26, 61, 0.95)'
+     * });
+     */
+    setTooltip(tooltipOptions: DeepPartial<TooltipOptions<TType>>): this;
     /**
      * @description 기존 옵션에 부분 옵션을 병합합니다.
      * @param {DeepPartial<TOptions>} options
@@ -1043,6 +1060,7 @@ declare abstract class CartesianChart<TType extends CartesianChartType> extends
     } | {
         id: string;
         _tooltips: WeakMap<WeakKey, any>;
+        _resolveLegendDatasetIndex(legendItem: any): number | undefined;
         afterInit(chart: any, args: any, options: any): void;
         beforeUpdate(chart: any, args: any, options: any): void;
         _handleGroupVisibility(chart: any, datasets: any[]): void;
@@ -1056,6 +1074,9 @@ declare abstract class CartesianChart<TType extends CartesianChartType> extends
     protected isLine(): boolean;
     protected isScatter(): boolean;
     protected isBar(): boolean;
+    protected applyGlobalZoomConfig(): void;
+    protected ensureZoomResetPlugin(): void;
+    protected removeZoomResetPlugin(): void;
     protected normalize(): void;
     protected configAop(config: any): any;
     /**
@@ -1186,14 +1207,31 @@ declare abstract class CartesianChart<TType extends CartesianChartType> extends
         lineWidth?: number;
     }): this;
     /**
-     * @description 줌 기능을 추가합니다. 해당 기능은 플러그인 설치가 필요합니다.
-     * @param defaultZoom
-     * @param zoomOption
+     * @description 줌 기능을 설정합니다. `false`를 전달하면 현재 차트의 줌 설정을 제거합니다.
+     * 전역 `setChartConfig({ zoom: true })` 설정이 있더라도 이 메서드로 차트별 비활성화가 가능합니다.
+     * @param {boolean} enabled
+     * @param {CustomZoomType<TType>} zoomOption
+     * @returns {this}
+     * @since 2.4.0
+     * @category Plugins
+     */
+    setZoom(enabled: boolean, zoomOption?: DeepPartialZoomType): this;
+    /**
+     * @deprecated `setZoom(enabled, zoomOption)`을 사용하세요.
+     * @description 레거시 줌 설정 메서드입니다. 내부적으로 `setZoom(true, ...)`를 호출합니다.
+     * @param defaultZoom - `true`이면 기본 줌 옵션을 적용합니다.
+     * @param zoomOption - 사용자 정의 줌 옵션입니다.
      * @returns {this}
      * @since 1.0.0
      * @category Plugins
      * @defaultValue defaultZoom = false
+     * @example
+     * // 기존 방식
+     * chart.addZoom(true);
      *
+     * @example
+     * // 권장 방식
+     * chart.setZoom(true);
      */
     addZoom(defaultZoom?: boolean, zoomOption?: object): this;
     /**
@@ -2740,6 +2778,7 @@ declare const chartMountPlugin: {
 declare const customDatasetPlugins: {
     id: string;
     _tooltips: WeakMap<WeakKey, any>;
+    _resolveLegendDatasetIndex(legendItem: any): number | undefined;
     afterInit(chart: any, args: any, options: any): void;
     beforeUpdate(chart: any, args: any, options: any): void;
     _handleGroupVisibility(chart: any, datasets: any[]): void;
@@ -3096,6 +3135,9 @@ interface StzConfig {
     errorLogging?: boolean;
     silentMode?: boolean;
     defaultColor?: string[];
+    zoom?: boolean | DeepPartialZoomType;
+    legend?: DeepPartial<LegendOptions<any>>;
+    tooltip?: DeepPartial<TooltipOptions<any>>;
     /** @deprecated no-op. Built-in chart types are bootstrapped at package load time. */
     autoRegister?: boolean;
     /** @deprecated no-op. Built-in chart types are bootstrapped at package load time. */
@@ -3112,7 +3154,14 @@ interface StzConfig {
  * setChartConfig({
  *   errorLogging: true,
  *   silentMode: false,
- *   defaultColor: ['#111111', '#22c55e', '#3b82f6']
+ *   defaultColor: ['#111111', '#22c55e', '#3b82f6'],
+ *   zoom: true,
+ *   legend: {
+ *     position: 'top'
+ *   },
+ *   tooltip: {
+ *     enabled: true
+ *   }
  * });
  * ```
  *