stz-chart-maker 1.3.2 → 1.4.0

package/README.md

@@ -6,8 +6,8 @@
 
 ## using npm :
   ```bash
-      npm install stz-chart-maker
-      npm install -D stz-chart-maker
+  npm install stz-chart-maker
+  npm install -D stz-chart-maker
   ```
 ## api Docs
 [📚 API 문서](https://stz-chart-maker.vercel.app)
@@ -41,4 +41,87 @@ const chart = ChartWrapper
 
 <Chart {...chart} />;
 ```
+
+## Configuration
+
+프로젝트 루트에 설정 파일을 생성하여 차트 동작을 커스터마이징할 수 있습니다.
+
+### 설정 파일 위치
+다음 중 하나의 위치에 설정 파일을 생성하세요:
+- `stz.config.js` (권장)
+- `.stzrc.js`
+- `src/stz.config.js`
+- `src/config/stz.config.js`
+- `config/stz.config.js`
+
+### 설정 예시
+
+```javascript
+// stz.config.js
+module.exports = {
+  // 에러 로깅 활성화/비활성화
+  errorLogging: true,
+
+  // 에러 발생 시 무시 (silent mode)
+  silentMode: false,
+
+  // 차트 기본 색상 커스터마이징
+  defaultColor: [
+    '#FF6B6B',
+    '#4ECDC4',
+    '#45B7D1',
+    '#FFA07A',
+    '#98D8C8',
+    '#F7DC6F'
+  ],
+
+  // 모든 차트 타입 자동 등록
+  autoRegister: true,
+
+  // 또는 특정 타입만 선택적으로 등록
+  // registerTypes: ['bar', 'line', 'doughnut']
+}
+```
+
+### 설정 옵션
+
+| 옵션 | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| `errorLogging` | `boolean` | `false` | 에러 로그 출력 여부 |
+| `silentMode` | `boolean` | `false` | 에러 발생 시 예외를 무시하고 계속 실행 |
+| `defaultColor` | `string[]` | 기본 색상 팔레트 | 차트에 사용할 기본 색상 배열 |
+| `autoRegister` | `boolean` | `false` | 모든 차트 타입 자동 등록 (bar, line, bubble, doughnut) |
+| `registerTypes` | `ChartType[]` | `[]` | 특정 차트 타입만 선택적으로 등록 |
+
+### 설정 없이 사용하기
+
+설정 파일이 없어도 라이브러리는 정상 작동합니다. 단, 차트를 사용하기 전에 수동으로 등록해야 합니다:
+
+```javascript
+import { ChartWrapper, BarChartWrapper, LineChartWrapper } from 'stz-chart-maker';
+
+// 차트 타입 등록
+ChartWrapper.register('bar', BarChartWrapper);
+ChartWrapper.register('line', LineChartWrapper);
+
+// 이제 사용 가능
+const chart = ChartWrapper.create('bar', labels, datasets);
+```
+
+### autoRegister vs registerTypes
+
+**모든 타입 자동 등록:**
+```javascript
+module.exports = {
+  autoRegister: true  // bar, line, bubble, doughnut 모두 등록
+}
+```
+
+**특정 타입만 등록:**
+```javascript
+module.exports = {
+  registerTypes: ['bar', 'line']  // bar와 line만 등록
+}
+```
+
 </div>

package/dist/index.d.ts

@@ -1,96 +1,48 @@
-import { ChartType, PluginOptionsByType, ChartOptions, GridLineOptions, FontSpec, Tick, Chart, ChartEvent, ActiveElement, LegendOptions, ChartDataset, Plugin as Plugin$1, TooltipItem, ChartTypeRegistry } from 'chart.js';
+import { ChartType, ChartDataset, GridLineOptions, FontSpec, Tick, PluginOptionsByType, ChartOptions, Chart, ChartEvent, ActiveElement, LegendOptions, Plugin as Plugin$1, TooltipItem, ChartTypeRegistry } from 'chart.js';
 import { ZoomPluginOptions } from 'chartjs-plugin-zoom/types/options';
 import { DeepPartial as DeepPartial$1 } from 'chart.js/dist/types/utils';
 
 /**
  * ═════════════════════════════════════════════════════════════
- * 📄 FILE     : zoomType.ts
- * 📁 PACKAGE  : chartjs-toolbox-
+ * 📄 FILE     : base.ts
+ * 📁 PACKAGE  : types
  * 👤 AUTHOR   : stz
- * 🕒 CREATED  : 25. 8. 8.
- * ═════════════════════════════════════════════════════════════
+ * 🕒 CREATED  : 2025.01.09
  * ═════════════════════════════════════════════════════════════
  * 📝 DESCRIPTION
- *   -
- * ═════════════════════════════════════════════════════════════
- * ═════════════════════════════════════════════════════════════
- * 🔄 CHANGE LOG
- *   - DATE : 2025/08/08 | Author : stz | 최초 생성
+ *   - 차트 라이브러리의 기본 타입 정의
+ *   - Align, Position, Color 등 공통 타입 별칭
+ *   - 차트 타입 분류 (Cartesian, Arc, Radial)
+ *   - 유틸리티 타입 (DeepPartial, Override)
  * ═════════════════════════════════════════════════════════════
  */
-
-interface PanOptions {
-    enabled: boolean;
-    mode?: 'x' | 'y' | 'xy';
-    modifierKey?: 'ctrl' | 'alt' | 'shift' | 'meta' | null;
-    scaleMode?: 'x' | 'y' | 'xy' | undefined;
-    overScaleMode?: 'x' | 'y' | 'xy' | undefined;
-    threshold?: number;
-}
-interface ZoomLimit {
-    min?: number;
-    max?: number;
-}
-type ZoomLimits = Record<string, ZoomLimit>;
-interface CustomZoomType<TType extends ChartType = ChartType> extends PluginOptionsByType<TType> {
-    zoom: ZoomPluginOptions;
-    pan?: PanOptions;
-    zoomLimits?: ZoomLimits;
-}
-type DeepPartialZoomType = DeepPartial$1<CustomZoomType>;
-
-interface DataLabelsContext {
-    chart: any;
-    dataset: any;
-    dataIndex: number;
-    datasetIndex: number;
-}
-interface DataLabels {
-    align: Position;
-    anchor: Position;
-    backgroundColor: string;
-    borderColor: string;
-    borderRadius: number;
-    borderWidth: number | ((ctx: DataLabelsContext) => number);
-    color: string | ((ctx: DataLabelsContext) => string);
-    display: boolean | ((ctx: DataLabelsContext) => boolean);
-    formatter: (value: any, ctx: DataLabelsContext) => string | number;
-    textStrokeColor: string | ((ctx: DataLabelsContext) => string);
-    textStrokeWidth: number | ((ctx: DataLabelsContext) => number);
-    textShadowBlur: number;
-    textShadowColor: string;
-}
-type PartialDataLabels = Partial<DataLabels>;
-
-/** ■■■■■■■■■■■■■■■■공통으로 사용하는 타입을 선언해놓습니다.■■■■■■■■■■■■■■■■*/
-
-interface ChartBuilder<TType extends ChartType> {
-    setPlugin(plugins: any): this;
-    removePlugin(pluginId: string): this;
-    build(id?: string): ChartConfig;
-    makeConfig(id?: string): ChartConfig;
-    hasPlugin(pluginId: string): boolean;
-    onResize(callback: (chart: Chart<TType>, size: {
-        width: number;
-        height: number;
-    }) => void): this;
-    setTitle(titleOptions: CommonCartesianTitleConfig): this;
-    setLegend(legendOptions: DeepPartial<LegendOptions<TType>>): this;
-    getChartData(uid: string): object;
-    setChartData(uid: string, data: CustomChartDatasets<TType>): void;
-}
 type Align = 'start' | 'center' | 'end';
 type Position = Align | 'left' | 'right' | 'top' | 'bottom';
+type Color = string | CanvasGradient | CanvasPattern;
+type Mode = 'default' | 'resize' | 'reset' | 'none' | 'hide' | 'show' | 'active';
 type CartesianChartType = 'line' | 'bar' | 'scatter' | 'bubble';
 type ArcChartType = 'doughnut' | 'pie';
 type RadialChartType = 'radar' | 'polarArea';
-type Color = string | CanvasGradient | CanvasPattern;
-type Mode = 'default' | 'resize' | 'reset' | 'none' | 'hide' | 'show' | 'active';
 type DeepPartial<T> = {
     [P in keyof T]?: T[P] extends object ? (T[P] extends Function ? T[P] : DeepPartial<T[P]>) : T[P];
 };
 type Override<T, U> = Omit<T, keyof U> & U;
-type CustomChartDatasets<TType extends ChartType = ChartType> = ChartDataset<TType, (number | null)[]> & {
+
+/**
+ * ═════════════════════════════════════════════════════════════
+ * 📄 FILE     : dataset.ts
+ * 📁 PACKAGE  : types
+ * 👤 AUTHOR   : stz
+ * 🕒 CREATED  : 2025.01.09
+ * ═════════════════════════════════════════════════════════════
+ * 📝 DESCRIPTION
+ *   - Dataset 관련 타입 정의
+ *   - CustomChartDatasets, ArcDataset, CartesianDataset
+ *   - 확장 속성 (_aux, _uid, _group 등)
+ * ═════════════════════════════════════════════════════════════
+ */
+
+interface DatasetExtensions {
     _aux?: any;
     _uid?: string;
     _group?: string | number;
@@ -99,34 +51,40 @@ type CustomChartDatasets<TType extends ChartType = ChartType> = ChartDataset<TTy
     _tooltip?: string | ((context: any) => string);
     _groupLabel?: string;
     _toggleBehavior?: 'normal' | 'radio' | 'disabled';
-};
-interface SettingOptions {
-    img: string;
-    iconSize: {
-        w: number;
-        h: number;
-    };
-    radiusExtra: number;
-    offset: {
-        right: number;
-        top: number;
-    };
-    colors: {
-        fill: string;
-        fillHover: string;
-        stroke: string;
-        strokeHover: string;
-    };
-    borderWidth: {
-        normal: number;
-        hover: number;
-    };
-    cursor: string;
-    onClick: (args: {
-        chart: Chart;
-        event: MouseEvent;
-    }) => void;
 }
+type CustomChartDatasets<TType extends ChartType = ChartType> = ChartDataset<TType, (number | null)[]> & DatasetExtensions;
+type ArcDataset<TType extends ArcChartType = ArcChartType> = ChartDataset<TType, (number | null)[]> & DatasetExtensions;
+type CartesianDataset<TType extends CartesianChartType = CartesianChartType> = ChartDataset<TType, (number | null)[]> & DatasetExtensions & {
+    yAxisID?: string;
+    xAxisID?: string;
+    stack?: string;
+    order?: number;
+    DATASET_ID?: string;
+};
+type CustomCartesianDataset<TType extends CartesianChartType = CartesianChartType> = ChartDataset<TType, (number | null)[]> & DatasetExtensions & {
+    yAxisID?: string;
+    xAxisID?: string;
+    stack?: string;
+    order?: number;
+    _dskey?: string;
+    image?: string;
+    images?: string[];
+};
+
+/**
+ * ═════════════════════════════════════════════════════════════
+ * 📄 FILE     : axes.ts
+ * 📁 PACKAGE  : types
+ * 👤 AUTHOR   : stz
+ * 🕒 CREATED  : 2025.01.09
+ * ═════════════════════════════════════════════════════════════
+ * 📝 DESCRIPTION
+ *   - Axes/Scales 관련 타입 정의
+ *   - CommonCartesianAxes, CommonAxesSacels
+ *   - Title, Legend, Ticks 설정
+ * ═════════════════════════════════════════════════════════════
+ */
+
 interface CommonCartesianTitleConfig {
     display?: boolean;
     align?: Align;
@@ -217,10 +175,127 @@ interface CommonCartesianAxes extends Omit<CommonAxes, 'ticks'>, Partial<CommonC
     ticks?: CommonCartesianTicks;
 }
 type DeepPartialCartesianAxes = DeepPartial<CommonCartesianAxes>;
-type DeepPartialPluginOptions<T extends ChartType> = DeepPartial<PluginOptionsByType<T>>;
 interface CommonAxesSacels {
     [key: string]: DeepPartialCartesianAxes;
 }
+
+/**
+ * ═════════════════════════════════════════════════════════════
+ * 📄 FILE     : zoomType.ts
+ * 📁 PACKAGE  : chartjs-toolbox-
+ * 👤 AUTHOR   : stz
+ * 🕒 CREATED  : 25. 8. 8.
+ * ═════════════════════════════════════════════════════════════
+ * ═════════════════════════════════════════════════════════════
+ * 📝 DESCRIPTION
+ *   -
+ * ═════════════════════════════════════════════════════════════
+ * ═════════════════════════════════════════════════════════════
+ * 🔄 CHANGE LOG
+ *   - DATE : 2025/08/08 | Author : stz | 최초 생성
+ * ═════════════════════════════════════════════════════════════
+ */
+
+interface PanOptions {
+    enabled: boolean;
+    mode?: 'x' | 'y' | 'xy';
+    modifierKey?: 'ctrl' | 'alt' | 'shift' | 'meta' | null;
+    scaleMode?: 'x' | 'y' | 'xy' | undefined;
+    overScaleMode?: 'x' | 'y' | 'xy' | undefined;
+    threshold?: number;
+}
+interface ZoomLimit {
+    min?: number;
+    max?: number;
+}
+type ZoomLimits = Record<string, ZoomLimit>;
+interface CustomZoomType<TType extends ChartType = ChartType> extends PluginOptionsByType<TType> {
+    zoom: ZoomPluginOptions;
+    pan?: PanOptions;
+    zoomLimits?: ZoomLimits;
+}
+type DeepPartialZoomType = DeepPartial$1<CustomZoomType>;
+
+interface DataLabelsContext {
+    chart: any;
+    dataset: any;
+    dataIndex: number;
+    datasetIndex: number;
+}
+interface DataLabels {
+    align: Position;
+    anchor: Position;
+    backgroundColor: string;
+    borderColor: string;
+    borderRadius: number;
+    borderWidth: number | ((ctx: DataLabelsContext) => number);
+    color: string | ((ctx: DataLabelsContext) => string);
+    display: boolean | ((ctx: DataLabelsContext) => boolean);
+    formatter: (value: any, ctx: DataLabelsContext) => string | number;
+    textStrokeColor: string | ((ctx: DataLabelsContext) => string);
+    textStrokeWidth: number | ((ctx: DataLabelsContext) => number);
+    textShadowBlur: number;
+    textShadowColor: string;
+}
+type PartialDataLabels = Partial<DataLabels>;
+
+/**
+ * ═════════════════════════════════════════════════════════════
+ * 📄 FILE     : options.ts
+ * 📁 PACKAGE  : types
+ * 👤 AUTHOR   : stz
+ * 🕒 CREATED  : 2025.01.09
+ * ═════════════════════════════════════════════════════════════
+ * 📝 DESCRIPTION
+ *   - ChartOptions 관련 타입 정의
+ *   - CustomChartOptions, CustomArcChartOptions
+ *   - CustomOptionPlugins, SettingOptions, HtmlLegendOptions
+ * ═════════════════════════════════════════════════════════════
+ */
+
+interface SettingOptions {
+    img: string;
+    iconSize: {
+        w: number;
+        h: number;
+    };
+    radiusExtra: number;
+    offset: {
+        right: number;
+        top: number;
+    };
+    colors: {
+        fill: string;
+        fillHover: string;
+        stroke: string;
+        strokeHover: string;
+    };
+    borderWidth: {
+        normal: number;
+        hover: number;
+    };
+    cursor: string;
+    onClick: (args: {
+        chart: Chart;
+        event: MouseEvent;
+    }) => void;
+}
+type HtmlLegendOptions = {
+    containerID: string;
+    className?: {
+        list?: string;
+        item?: string;
+        box?: string;
+        text?: string;
+    };
+    styles?: {
+        text?: Record<string, string>;
+        textHidden?: Record<string, string>;
+        box?: (item: any, type: string, chart: Chart) => Record<string, string | number>;
+    };
+    getItemText?: (item: any) => string;
+    getDatasetType?: (chart: Chart, item: Record<string, any>) => string | undefined;
+};
 type CustomOptionPlugins<TType extends ChartType = ChartType> = DeepPartial<PluginOptionsByType<TType>> & {
     zoom?: DeepPartialZoomType;
     datalabels?: PartialDataLabels;
@@ -241,6 +316,7 @@ type CustomOptionPlugins<TType extends ChartType = ChartType> = DeepPartial<Plug
     };
     htmlLegend?: HtmlLegendOptions;
 };
+type DeepPartialPluginOptions<T extends ChartType> = DeepPartial<PluginOptionsByType<T>>;
 type CustomChartOptions<TType extends ChartType = ChartType> = Override<ChartOptions<TType>, {
     scales?: CommonAxesSacels;
     plugins?: CustomOptionPlugins<TType>;
@@ -261,6 +337,7 @@ type CustomChartOptions<TType extends ChartType = ChartType> = Override<ChartOpt
 }> & {
     _mounted?: (chart: Chart<TType>) => void;
     _chartId?: string;
+    _loading?: boolean;
 };
 type CustomArcChartOptions<TType extends ArcChartType = ArcChartType> = CustomChartOptions<TType> & {
     scales?: never;
@@ -274,62 +351,37 @@ type CustomLineChartOptions = CustomChartOptions<'line'>;
 type CustomBubbleChartOptions = CustomChartOptions<'bubble'>;
 type CustomPieChartOptions = CustomArcChartOptions<'pie'>;
 type CustomDoughnutChartOptions = CustomArcChartOptions<'doughnut'>;
-type ArcDataset<TType extends ArcChartType = ArcChartType> = ChartDataset<TType, (number | null)[]> & {
-    _aux?: boolean;
-    _group?: string | number;
-    _legendOrder?: number;
-    _visible?: boolean;
-    _tooltip?: string | ((context: any) => string);
-    _groupLabel?: string;
-    _toggleBehavior?: 'normal' | 'radio' | 'disabled';
-};
-type CartesianDataset<TType extends CartesianChartType = CartesianChartType> = ChartDataset<TType, (number | null)[]> & {
-    yAxisID?: string;
-    xAxisID?: string;
-    stack?: string;
-    order?: number;
-    DATASET_ID?: string;
-    _aux?: boolean;
-    _group?: string | number;
-    _legendOrder?: number;
-    _visible?: boolean;
-    _tooltip?: string | ((context: any) => string);
-    _groupLabel?: string;
-    _toggleBehavior?: 'normal' | 'radio' | 'disabled';
-};
-type Constructor<TType extends ChartType, TInstance> = new (type: TType, labels: (string | number)[], datasets: ChartDataset<TType, (number | null)[]>[], options?: CustomChartOptions<TType>, plugins?: []) => TInstance;
-type CustomCartesianDataset<TType extends CartesianChartType = CartesianChartType> = ChartDataset<TType, (number | null)[]> & {
-    yAxisID?: string;
-    xAxisID?: string;
-    stack?: string;
-    order?: number;
-    _dskey?: string;
-    image?: string;
-    images?: string[];
-    _aux?: boolean;
-    _group?: string | number;
-    _legendOrder?: number;
-    _visible?: boolean;
-    _tooltip?: string | ((context: any) => string);
-    _groupLabel?: string;
-    _toggleBehavior?: 'normal' | 'radio' | 'disabled';
-};
-type HtmlLegendOptions = {
-    containerID: string;
-    className?: {
-        list?: string;
-        item?: string;
-        box?: string;
-        text?: string;
-    };
-    styles?: {
-        text?: Record<string, string>;
-        textHidden?: Record<string, string>;
-        box?: (item: any, type: string, chart: Chart) => Record<string, string | number>;
-    };
-    getItemText?: (item: any) => string;
-    getDatasetType?: (chart: Chart, item: Record<string, any>) => string | undefined;
-};
+type Constructor<TType extends ChartType, TInstance> = new (type: TType, labels: (string | number)[], datasets: any[], options?: CustomChartOptions<TType>, plugins?: []) => TInstance;
+
+/**
+ * ═════════════════════════════════════════════════════════════
+ * 📄 FILE     : builders.ts
+ * 📁 PACKAGE  : types
+ * 👤 AUTHOR   : stz
+ * 🕒 CREATED  : 2025.01.09
+ * ═════════════════════════════════════════════════════════════
+ * 📝 DESCRIPTION
+ *   - ChartBuilder 인터페이스 정의
+ *   - CartesianChartBuilder, ArcChartBuilder 등
+ *   - 각 차트 타입별 Builder 인터페이스
+ * ═════════════════════════════════════════════════════════════
+ */
+
+interface ChartBuilder<TType extends string> {
+    setPlugin(plugins: any): this;
+    removePlugin(pluginId: string): this;
+    build(id?: string): ChartConfig;
+    makeConfig(id?: string): ChartConfig;
+    hasPlugin(pluginId: string): boolean;
+    onResize(callback: (chart: Chart<any>, size: {
+        width: number;
+        height: number;
+    }) => void): this;
+    setTitle(titleOptions: CommonCartesianTitleConfig): this;
+    setLegend(legendOptions: DeepPartial<LegendOptions<any>>): this;
+    getChartData(uid: string): object;
+    setChartData(uid: string, data: CustomChartDatasets<any>): void;
+}
 interface CartesianChartBuilder<TType extends CartesianChartType> extends ChartBuilder<TType> {
     setScales(scales: CommonAxesSacels): this;
     setAxisTitle(axis: 'x' | 'y', titleConfig: CommonCartesianTitleConfig): this;
@@ -383,18 +435,6 @@ interface LineChartBuilder extends CartesianChartBuilder<'line'> {
     setAllPointHoverRadius(hoverRadius: number): this;
     sparkLineChart(): this;
 }
-interface RadarChartBuilder extends ChartBuilder<'radar'> {
-}
-interface ArcChartBuilder<TType extends ArcChartType> extends ChartBuilder<TType> {
-    setRotation(rotation: number): this;
-    setCircumference(circumference: number): this;
-    setCutout(cutout: string | number): this;
-    setRadius(radius: string | number): this;
-    setBorderWidth(datasetIndex: number, borderWidth: number): this;
-    setAllBorderWidth(borderWidth: number): this;
-    setBorderColor(datasetIndex: number, borderColor: string | string[]): this;
-    setAllBorderColor(borderColor: string | string[]): this;
-}
 interface BubbleChartBuilder extends CartesianChartBuilder<'bubble'> {
     setBubbleRadius(datasetIndex: number, radius: number): this;
     setBubbleDataRadius(datasetIndex: number, dataIndex: number, radius: number): this;
@@ -411,6 +451,16 @@ interface BubbleChartBuilder extends CartesianChartBuilder<'bubble'> {
     setAllRotation(rotation: number): this;
     sparkBubbleChart(): this;
 }
+interface ArcChartBuilder<TType extends ArcChartType> extends ChartBuilder<TType> {
+    setRotation(rotation: number): this;
+    setCircumference(circumference: number): this;
+    setCutout(cutout: string | number): this;
+    setRadius(radius: string | number): this;
+    setBorderWidth(datasetIndex: number, borderWidth: number): this;
+    setAllBorderWidth(borderWidth: number): this;
+    setBorderColor(datasetIndex: number, borderColor: string | string[]): this;
+    setAllBorderColor(borderColor: string | string[]): this;
+}
 interface PieChartBuilder extends ArcChartBuilder<'pie'> {
 }
 interface DoughnutChartBuilder extends ArcChartBuilder<'doughnut'> {
@@ -426,6 +476,24 @@ interface DoughnutChartBuilder extends ArcChartBuilder<'doughnut'> {
         maxFontSize?: number;
     }): this;
 }
+interface RadarChartBuilder extends ChartBuilder<'radar'> {
+}
+
+/**
+ * ═════════════════════════════════════════════════════════════
+ * 📄 FILE     : commonTypes.ts
+ * 📁 PACKAGE  : types
+ * 👤 AUTHOR   : stz
+ * 🕒 CREATED  : 2025.01.09
+ * ═════════════════════════════════════════════════════════════
+ * 📝 DESCRIPTION
+ *   - 모든 타입을 한 곳에서 export (기존 호환성 유지)
+ *   - 개별 타입 파일로 분리된 타입들을 re-export
+ * ═════════════════════════════════════════════════════════════
+ * 🔄 CHANGE LOG
+ *   - 2025.01.09 | stz | 타입 파일 분리 및 구조화
+ * ═════════════════════════════════════════════════════════════
+ */
 
 type Types_Align = Align;
 type Types_ArcChartBuilder<TType extends ArcChartType> = ArcChartBuilder<TType>;
@@ -436,7 +504,7 @@ type Types_BubbleChartBuilder = BubbleChartBuilder;
 type Types_CartesianChartBuilder<TType extends CartesianChartType> = CartesianChartBuilder<TType>;
 type Types_CartesianChartType = CartesianChartType;
 type Types_CartesianDataset<TType extends CartesianChartType = CartesianChartType> = CartesianDataset<TType>;
-type Types_ChartBuilder<TType extends ChartType> = ChartBuilder<TType>;
+type Types_ChartBuilder<TType extends string> = ChartBuilder<TType>;
 type Types_Color = Color;
 type Types_CommonAxes = CommonAxes;
 type Types_CommonAxesSacels = CommonAxesSacels;
@@ -464,13 +532,14 @@ type Types_DoughnutChartBuilder = DoughnutChartBuilder;
 type Types_HtmlLegendOptions = HtmlLegendOptions;
 type Types_LineChartBuilder = LineChartBuilder;
 type Types_Mode = Mode;
+type Types_Override<T, U> = Override<T, U>;
 type Types_PieChartBuilder = PieChartBuilder;
 type Types_Position = Position;
 type Types_RadarChartBuilder = RadarChartBuilder;
 type Types_RadialChartType = RadialChartType;
 type Types_SettingOptions = SettingOptions;
 declare namespace Types {
-  export type { Types_Align as Align, Types_ArcChartBuilder as ArcChartBuilder, Types_ArcChartType as ArcChartType, Types_ArcDataset as ArcDataset, Types_BarChartBuilder as BarChartBuilder, Types_BubbleChartBuilder as BubbleChartBuilder, Types_CartesianChartBuilder as CartesianChartBuilder, Types_CartesianChartType as CartesianChartType, Types_CartesianDataset as CartesianDataset, Types_ChartBuilder as ChartBuilder, Types_Color as Color, Types_CommonAxes as CommonAxes, Types_CommonAxesSacels as CommonAxesSacels, Types_CommonCartesian as CommonCartesian, Types_CommonCartesianAxes as CommonCartesianAxes, Types_CommonCartesianLegendConfig as CommonCartesianLegendConfig, Types_CommonCartesianTicks as CommonCartesianTicks, Types_CommonCartesianTitleConfig as CommonCartesianTitleConfig, Types_CommonTicks as CommonTicks, Types_Constructor as Constructor, Types_CustomArcChartOptions as CustomArcChartOptions, Types_CustomBarChartOptions as CustomBarChartOptions, Types_CustomBubbleChartOptions as CustomBubbleChartOptions, Types_CustomCartesianDataset as CustomCartesianDataset, Types_CustomChartDatasets as CustomChartDatasets, Types_CustomChartOptions as CustomChartOptions, Types_CustomDoughnutChartOptions as CustomDoughnutChartOptions, Types_CustomLineChartOptions as CustomLineChartOptions, Types_CustomOptionPlugins as CustomOptionPlugins, Types_CustomPieChartOptions as CustomPieChartOptions, Types_DeepPartial as DeepPartial, Types_DeepPartialCartesianAxes as DeepPartialCartesianAxes, Types_DeepPartialPluginOptions as DeepPartialPluginOptions, Types_DoughnutChartBuilder as DoughnutChartBuilder, Types_HtmlLegendOptions as HtmlLegendOptions, Types_LineChartBuilder as LineChartBuilder, Types_Mode as Mode, Types_PieChartBuilder as PieChartBuilder, Types_Position as Position, Types_RadarChartBuilder as RadarChartBuilder, Types_RadialChartType as RadialChartType, Types_SettingOptions as SettingOptions };
+  export type { Types_Align as Align, Types_ArcChartBuilder as ArcChartBuilder, Types_ArcChartType as ArcChartType, Types_ArcDataset as ArcDataset, Types_BarChartBuilder as BarChartBuilder, Types_BubbleChartBuilder as BubbleChartBuilder, Types_CartesianChartBuilder as CartesianChartBuilder, Types_CartesianChartType as CartesianChartType, Types_CartesianDataset as CartesianDataset, Types_ChartBuilder as ChartBuilder, Types_Color as Color, Types_CommonAxes as CommonAxes, Types_CommonAxesSacels as CommonAxesSacels, Types_CommonCartesian as CommonCartesian, Types_CommonCartesianAxes as CommonCartesianAxes, Types_CommonCartesianLegendConfig as CommonCartesianLegendConfig, Types_CommonCartesianTicks as CommonCartesianTicks, Types_CommonCartesianTitleConfig as CommonCartesianTitleConfig, Types_CommonTicks as CommonTicks, Types_Constructor as Constructor, Types_CustomArcChartOptions as CustomArcChartOptions, Types_CustomBarChartOptions as CustomBarChartOptions, Types_CustomBubbleChartOptions as CustomBubbleChartOptions, Types_CustomCartesianDataset as CustomCartesianDataset, Types_CustomChartDatasets as CustomChartDatasets, Types_CustomChartOptions as CustomChartOptions, Types_CustomDoughnutChartOptions as CustomDoughnutChartOptions, Types_CustomLineChartOptions as CustomLineChartOptions, Types_CustomOptionPlugins as CustomOptionPlugins, Types_CustomPieChartOptions as CustomPieChartOptions, Types_DeepPartial as DeepPartial, Types_DeepPartialCartesianAxes as DeepPartialCartesianAxes, Types_DeepPartialPluginOptions as DeepPartialPluginOptions, Types_DoughnutChartBuilder as DoughnutChartBuilder, Types_HtmlLegendOptions as HtmlLegendOptions, Types_LineChartBuilder as LineChartBuilder, Types_Mode as Mode, Types_Override as Override, Types_PieChartBuilder as PieChartBuilder, Types_Position as Position, Types_RadarChartBuilder as RadarChartBuilder, Types_RadialChartType as RadialChartType, Types_SettingOptions as SettingOptions };
 }
 
 interface ChartConfig {
@@ -1985,7 +2054,7 @@ declare enum ChartTypes {
 
 declare const ChartToolBox: {
     setErrorLog(enabled?: boolean): void;
-    setErrorshield(enabled?: boolean): void;
+    setErrorShield(enabled?: boolean): void;
 };
 declare const T$: {
     readonly create: typeof ChartWrapper.create;
@@ -2001,9 +2070,9 @@ declare const T$: {
     readonly defaultsOptions: typeof LocalDefaults;
     readonly toolBox: {
         setErrorLog(enabled?: boolean): void;
-        setErrorshield(enabled?: boolean): void;
+        setErrorShield(enabled?: boolean): void;
     };
 };
 
 export { ArcChartWrapper, BarChartWrapper, BubbleChartWrapper, CartesianChartWrapper, ChartFactory, ChartInstance, ChartToolBox, ChartTypes, ChartWrapper, CreateZoomRangeSlider, DoughnutChartWrapper, LineChartWrapper, T$, barScaleImgPlugin, blinkPlugin, changeSetting, chartMountPlugin, createDefaultBarOptions, createDefaultBubbleOptions, createDefaultLineOptions, customLegend, T$ as default, defaultBarScales, defaultBarTooltipCallback, defaultBubbleScales, defaultBubbleTooltipCallback, defaultLineScales, defaultLineTooltipCallback, doughnutCenterTextPlugin, loadingPlugin, makeCenterHtml, noDataPlugin, sparkBarOptions, sparkBubbleOptions, sparkLineOptions, zoomRangeSlider, zoomResetPlugin };
-export type { Align, AllChartTypes, ArcChartBuilder, ArcChartType, ArcDataset, AxisColors, BarChartBuilder, BubbleChartBuilder, CartesianChartBuilder, CartesianChartType, CartesianDataset, ChartBuilder, ChartWithFocus, Color, CommonAxes, CommonAxesSacels, CommonCartesian, CommonCartesianAxes, CommonCartesianLegendConfig, CommonCartesianTicks, CommonCartesianTitleConfig, CommonTicks, Constructor, CustomArcChartOptions, CustomBarChartOptions, CustomBubbleChartOptions, CustomCartesianDataset, CustomChartDatasets, CustomChartOptions, CustomDoughnutChartOptions, CustomLineChartOptions, CustomOptionPlugins, CustomPieChartOptions, CustomZoomType, DataLabels, DataLabelsContext, DatasetWithPrevColors, DeepPartial, DeepPartialCartesianAxes, DeepPartialPluginOptions, DeepPartialZoomType, DoughnutChartBuilder, FocusCallback, HtmlLegendOptions, LineChartBuilder, Mode, OriginalColors, PartialDataLabels, PieChartBuilder, Position, RadarChartBuilder, RadialChartType, ScaleWithOriginalColors, SettingOptions, ZoomRangeSliderColors, ZoomRangeSliderPlugin, ZoomRangeSliderVar };
+export type { Align, AllChartTypes, ArcChartBuilder, ArcChartType, ArcDataset, AxisColors, BarChartBuilder, BubbleChartBuilder, CartesianChartBuilder, CartesianChartType, CartesianDataset, ChartBuilder, ChartWithFocus, Color, CommonAxes, CommonAxesSacels, CommonCartesian, CommonCartesianAxes, CommonCartesianLegendConfig, CommonCartesianTicks, CommonCartesianTitleConfig, CommonTicks, Constructor, CustomArcChartOptions, CustomBarChartOptions, CustomBubbleChartOptions, CustomCartesianDataset, CustomChartDatasets, CustomChartOptions, CustomDoughnutChartOptions, CustomLineChartOptions, CustomOptionPlugins, CustomPieChartOptions, CustomZoomType, DataLabels, DataLabelsContext, DatasetWithPrevColors, DeepPartial, DeepPartialCartesianAxes, DeepPartialPluginOptions, DeepPartialZoomType, DoughnutChartBuilder, FocusCallback, HtmlLegendOptions, LineChartBuilder, Mode, OriginalColors, Override, PartialDataLabels, PieChartBuilder, Position, RadarChartBuilder, RadialChartType, ScaleWithOriginalColors, SettingOptions, ZoomRangeSliderColors, ZoomRangeSliderPlugin, ZoomRangeSliderVar };