stz-chart-maker 1.0.18 → 1.1.0

package/dist/index.d.ts

@@ -68,9 +68,17 @@ 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;
 }
 type Position = 'start' | 'center' | 'end' | 'left' | 'right' | 'top' | 'bottom';
 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> = {
@@ -220,9 +228,17 @@ type CustomChartOptions<TType extends ChartType = ChartType> = Override<ChartOpt
     _mounted?: (chart: Chart<TType>) => void;
     _chartId?: string;
 };
+type CustomArcChartOptions<TType extends ArcChartType = ArcChartType> = CustomChartOptions<TType> & {
+    scales?: never;
+    rotation?: number;
+    circumference?: number;
+    cutout?: string | number;
+    radius?: number | string;
+};
 type CustomBarChartOptions = CustomChartOptions<'bar'>;
 type CustomLineChartOptions = CustomChartOptions<'line'>;
-type CustomPieChartOptions = CustomChartOptions<'pie'>;
+type CustomPieChartOptions = CustomArcChartOptions<'pie'>;
+type CustomDoughnutChartOptions = CustomArcChartOptions<'doughnut'>;
 type CartesianDataset<TType extends CartesianChartType = CartesianChartType> = ChartDataset<TType, (number | null)[]> & {
     yAxisID?: string;
     xAxisID?: string;
@@ -257,8 +273,6 @@ type HtmlLegendOptions = {
     getDatasetType?: (chart: Chart, item: Record<string, any>) => string | undefined;
 };
 interface CartesianChartBuilder<TType extends CartesianChartType> extends ChartBuilder<TType> {
-    makeConfig(id?: string): any;
-    hasPlugin(pluginId: string): boolean;
     setScales(scales: CommonAxesSacels): this;
     setAxisTitle(axis: 'x' | 'y', titleConfig: CommonCartesianTitleConfig): this;
     setGridOptions(axis: 'x' | 'y', gridOptions: {
@@ -307,7 +321,25 @@ interface LineChartBuilder extends CartesianChartBuilder<'line'> {
     setPointHoverRadius(datasetIndex: number, hoverRadius: number): this;
     setAllPointHoverRadius(hoverRadius: number): 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 PieChartBuilder extends ArcChartBuilder<'pie'> {
+}
+interface DoughnutChartBuilder extends ArcChartBuilder<'doughnut'> {
+}
 
+type Types_ArcChartBuilder<TType extends ArcChartType> = ArcChartBuilder<TType>;
+type Types_ArcChartType = ArcChartType;
 type Types_BarChartBuilder = BarChartBuilder;
 type Types_CartesianChartBuilder<TType extends CartesianChartType> = CartesianChartBuilder<TType>;
 type Types_CartesianChartType = CartesianChartType;
@@ -322,22 +354,28 @@ type Types_CommonCartesianTicks = CommonCartesianTicks;
 type Types_CommonCartesianTitleConfig = CommonCartesianTitleConfig;
 type Types_CommonTicks = CommonTicks;
 type Types_Constructor<TType extends ChartType, TInstance> = Constructor<TType, TInstance>;
+type Types_CustomArcChartOptions<TType extends ArcChartType = ArcChartType> = CustomArcChartOptions<TType>;
 type Types_CustomBarChartOptions = CustomBarChartOptions;
 type Types_CustomCartesianDataset<TType extends CartesianChartType = CartesianChartType> = CustomCartesianDataset<TType>;
 type Types_CustomChartOptions<TType extends ChartType = ChartType> = CustomChartOptions<TType>;
+type Types_CustomDoughnutChartOptions = CustomDoughnutChartOptions;
 type Types_CustomLineChartOptions = CustomLineChartOptions;
 type Types_CustomOptionPlugins<TType extends ChartType = ChartType> = CustomOptionPlugins<TType>;
 type Types_CustomPieChartOptions = CustomPieChartOptions;
 type Types_DeepPartial<T> = DeepPartial<T>;
 type Types_DeepPartialCartesianAxes = DeepPartialCartesianAxes;
 type Types_DeepPartialPluginOptions<T extends ChartType> = DeepPartialPluginOptions<T>;
+type Types_DoughnutChartBuilder = DoughnutChartBuilder;
 type Types_HtmlLegendOptions = HtmlLegendOptions;
 type Types_LineChartBuilder = LineChartBuilder;
 type Types_Mode = Mode;
+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_BarChartBuilder as BarChartBuilder, 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_CommonCartesianTicks as CommonCartesianTicks, Types_CommonCartesianTitleConfig as CommonCartesianTitleConfig, Types_CommonTicks as CommonTicks, Types_Constructor as Constructor, Types_CustomBarChartOptions as CustomBarChartOptions, Types_CustomCartesianDataset as CustomCartesianDataset, Types_CustomChartOptions as CustomChartOptions, 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_HtmlLegendOptions as HtmlLegendOptions, Types_LineChartBuilder as LineChartBuilder, Types_Mode as Mode, Types_Position as Position, Types_SettingOptions as SettingOptions };
+  export type { Types_ArcChartBuilder as ArcChartBuilder, Types_ArcChartType as ArcChartType, Types_BarChartBuilder as BarChartBuilder, 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_CommonCartesianTicks as CommonCartesianTicks, Types_CommonCartesianTitleConfig as CommonCartesianTitleConfig, Types_CommonTicks as CommonTicks, Types_Constructor as Constructor, Types_CustomArcChartOptions as CustomArcChartOptions, Types_CustomBarChartOptions as CustomBarChartOptions, Types_CustomCartesianDataset as CustomCartesianDataset, 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 };
 }
 
 interface ChartConfig {
@@ -348,15 +386,15 @@ interface ChartConfig {
     options: any;
     plugins?: any;
 }
-declare abstract class ChartWrapper<TType extends ChartType> implements ChartBuilder<TType> {
+declare abstract class ChartWrapper<TType extends ChartType, TOptions extends CustomChartOptions<TType> = CustomChartOptions<TType>> implements ChartBuilder<TType> {
     protected type: TType;
     protected labels: (string | number)[];
     protected datasets: ChartDataset<TType, (number | null)[]>[];
-    protected options: CustomChartOptions<TType>;
+    protected options: TOptions;
     protected plugins?: any | undefined;
     static registry: Map<string, Constructor<any, any>>;
-    constructor(type: TType, labels: (string | number)[], datasets: ChartDataset<TType, (number | null)[]>[], options: CustomChartOptions<TType>, plugins?: any | undefined);
-    static create<TType extends ChartType>(type: TType, labels: (string | number)[], datasets: ChartDataset<TType, (number | null)[]>[], options?: CustomChartOptions<TType>, plugins?: any): TType extends CartesianChartType ? CartesianChartBuilder<TType> : ChartBuilder<TType>;
+    constructor(type: TType, labels: (string | number)[], datasets: ChartDataset<TType, (number | null)[]>[], options: TOptions, plugins?: any | undefined);
+    static create<TType extends ChartType>(type: TType, labels: (string | number)[], datasets: ChartDataset<TType, (number | null)[]>[], options?: CustomChartOptions<TType>, plugins?: Plugin$1): TType extends CartesianChartType ? CartesianChartBuilder<TType> : TType extends ArcChartType ? ArcChartBuilder<TType> : ChartBuilder<TType>;
     static register<TType extends ChartType, TInstance>(type: TType, wrapperClass: Constructor<TType, TInstance>): void;
     static has(type: ChartType): boolean;
     protected abstract normalize(): void;
@@ -1033,6 +1071,227 @@ declare class LineChartWrapper extends CartesianChartWrapper<'line'> implements
     private calculateGradientPositions;
 }
 
+/**
+ * ═════════════════════════════════════════════════════════════
+ * 📄 FILE     : ArcChartWrapper.ts
+ * 📁 PACKAGE  : chart-toolbox
+ * 👤 AUTHOR   : stz
+ * 🕒 CREATED  : 25. 9. 28.
+ * ═════════════════════════════════════════════════════════════
+ * ═════════════════════════════════════════════════════════════
+ * 📝 DESCRIPTION
+ *   Arc Chart (Pie, Doughnut) 를 위한 추상 클래스
+ * ═════════════════════════════════════════════════════════════
+ * ═════════════════════════════════════════════════════════════
+ * 🔄 CHANGE LOG
+ *   - DATE : 2025/09/28 | Author : stz | 최초 생성
+ * ═════════════════════════════════════════════════════════════
+ */
+
+declare abstract class ArcChartWrapper<TType extends ArcChartType> extends ChartWrapper<TType> implements ArcChartBuilder<TType> {
+    readonly type: TType;
+    private _chartId?;
+    protected constructor(type: TType, labels: (string | number)[], datasets: ChartDataset<TType, (number | null)[]>[], options?: CustomArcChartOptions<TType>, plugins?: Plugin$1);
+    get chartId(): string;
+    set chartId(value: string);
+    protected requireLabels(): boolean;
+    /**
+     * @protected
+     * @description 데이터셋의 기본적인 옵션을 추가하거나 부여합니다. (Arc 차트용)
+     * @param ds
+     * @param {number} idx
+     * @Returns {void}
+     * @Since 1.0.1
+     * @category Dataset
+     * @beta
+     */
+    protected decorateDataset(ds: any, idx: number): void;
+    protected mustHavePlugins(): {
+        id: string;
+        afterDraw(chart: any, args: any, options: any): void;
+    }[];
+    protected normalize(): void;
+    protected configAop(config: any): any;
+    /**
+     * @Description 차트 설정 객체를 생성합니다. 이 메소드는 차트의 구성 요소를 종합하여 Chart.js에서 사용할 수 있는 형식으로 반환합니다.
+     * @param id
+     * @returns {ChartConfig}
+     * @Since 1.0.0
+     * @category Chart
+     * @beta
+     */
+    build(id?: string): ChartConfig;
+    /**
+     * @description 도넛/파이 차트의 회전 각도를 설정합니다.
+     * @param rotation - 시작 각도 (도 단위)
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     * @beta
+     */
+    setRotation(rotation: number): this;
+    /**
+     * @description 도넛/파이 차트의 원주각을 설정합니다.
+     * @param circumference - 원주각 (도 단위, 360 = 완전한 원)
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     * @beta
+     */
+    setCircumference(circumference: number): this;
+    /**
+     * @description 도넛 차트의 중앙 구멍 크기를 설정합니다.
+     * @param cutout - 구멍 크기 (퍼센트 문자열 또는 픽셀 숫자)
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     * @beta
+     */
+    setCutout(cutout: string | number): this;
+    /**
+     * @description 차트의 반지름을 설정합니다.
+     * @param radius - 반지름 (퍼센트 문자열 또는 픽셀 숫자)
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     * @beta
+     */
+    setRadius(radius: string | number): this;
+    /**
+     * @description 데이터셋의 경계선 너비를 설정합니다.
+     * @param datasetIndex - 데이터셋 인덱스
+     * @param borderWidth - 경계선 너비
+     * @returns {this}
+     * @since 1.0.0
+     * @category Dataset
+     * @beta
+     */
+    setBorderWidth(datasetIndex: number, borderWidth: number): this;
+    /**
+     * @description 모든 데이터셋의 경계선 너비를 설정합니다.
+     * @param borderWidth - 경계선 너비
+     * @returns {this}
+     * @since 1.0.0
+     * @category Dataset
+     * @beta
+     */
+    setAllBorderWidth(borderWidth: number): this;
+    /**
+     * @description 데이터셋의 경계선 색상을 설정합니다.
+     * @param datasetIndex - 데이터셋 인덱스
+     * @param borderColor - 경계선 색상
+     * @returns {this}
+     * @since 1.0.0
+     * @category Dataset
+     * @beta
+     */
+    setBorderColor(datasetIndex: number, borderColor: string | string[]): this;
+    /**
+     * @description 모든 데이터셋의 경계선 색상을 설정합니다.
+     * @param borderColor - 경계선 색상
+     * @returns {this}
+     * @since 1.0.0
+     * @category Dataset
+     * @beta
+     */
+    setAllBorderColor(borderColor: string | string[]): this;
+}
+
+declare class DoughnutChartWrapper extends ArcChartWrapper<'doughnut'> implements DoughnutChartBuilder {
+    constructor(type: 'doughnut', labels: (string | number)[], datasets: ChartDataset<'doughnut', (number | null)[]>[], options?: CustomDoughnutChartOptions, plugins?: any);
+    protected requireLabels(): boolean;
+    /**
+     * @description 레거시 지원용 차트 설정 객체를 생성합니다.
+     * @param {string} id
+     * @returns {ChartConfig}
+     * @Since 1.0.0
+     * @category config
+     * @beta
+     */
+    makeConfig(id?: string): ChartConfig;
+    /**
+     * @description 도넛 구멍 크기를 설정합니다.
+     * @param cutout - 구멍 크기 ('50%', '60%' 또는 픽셀값)
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     * @beta
+     */
+    setCutout(cutout: string | number): this;
+    /**
+     * @description 도넛 차트를 파이 차트로 변경합니다 (구멍 제거).
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     * @beta
+     */
+    convertToPie(): this;
+    /**
+     * @description 모든 세그먼트의 색상을 설정합니다.
+     * @param colors - 색상 배열
+     * @returns {this}
+     * @since 1.0.0
+     * @category Dataset
+     * @beta
+     */
+    setSegmentColors(colors: string[]): this;
+    /**
+     * @description 특정 세그먼트만 분리해서 표시합니다.
+     * @param dataIndex - 분리할 데이터 인덱스
+     * @param offset - 분리 거리 (픽셀)
+     * @returns {this}
+     * @since 1.0.0
+     * @category Dataset
+     * @beta
+     */
+    setSegmentOffset(dataIndex: number, offset: number): this;
+    /**
+     * @description 차트의 시작 각도를 설정합니다.
+     * @param rotation - 회전 각도 (도 단위)
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     * @beta
+     */
+    setRotation(rotation: number): this;
+    /**
+     * @description 차트의 원주각을 설정합니다.
+     * @param circumference - 원주각 (도 단위, 360 = 완전한 원)
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     * @beta
+     */
+    setCircumference(circumference: number): this;
+    /**
+     * @description 차트의 반지름을 설정합니다.
+     * @param radius - 반지름 ('90%', '100%' 또는 픽셀값)
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     * @beta
+     */
+    setRadius(radius: string | number): this;
+    /**
+     * @description 모든 데이터셋의 경계선 너비를 설정합니다.
+     * @param borderWidth - 경계선 너비
+     * @returns {this}
+     * @since 1.0.0
+     * @category Dataset
+     * @beta
+     */
+    setAllBorderWidth(borderWidth: number): this;
+    /**
+     * @description 모든 데이터셋의 경계선 색상을 설정합니다.
+     * @param borderColor - 경계선 색상
+     * @returns {this}
+     * @since 1.0.0
+     * @category Dataset
+     * @beta
+     */
+    setAllBorderColor(borderColor: string | string[]): this;
+}
+
 declare const noDataPlugin: {
     id: string;
     beforeUpdate: (chart: any) => void;
@@ -1213,6 +1472,8 @@ declare const T$: {
     readonly CartesianChartWrapper: typeof CartesianChartWrapper;
     readonly BarChartWrapper: typeof BarChartWrapper;
     readonly LineChartWrapper: typeof LineChartWrapper;
+    readonly ArcChartWrapper: typeof ArcChartWrapper;
+    readonly DoughnutChartWrapper: typeof DoughnutChartWrapper;
     readonly defaultTypes: typeof Types;
     readonly defaultsOptions: typeof LocalDefaults;
     readonly toolBox: {
@@ -1220,5 +1481,5 @@ declare const T$: {
     };
 };
 
-export { BarChartWrapper, CartesianChartWrapper, ChartFactory, ChartInstance, ChartToolBox, ChartTypes, ChartWrapper, CreateZoomRangeSlider, LineChartWrapper, T$, barScaleImgPlugin, blinkPlugin, changeSetting, chartMountPlugin, createDefaultBarOptions, createDefaultLineOptions, customLegend, T$ as default, defaultBarScales, defaultBarTooltipCallback, defaultLineScales, defaultLineTooltipCallback, doughnutCenterTextPlugin, loadingPlugin, makeCenterHtml, noDataPlugin, zoomRangeSlider, zoomResetPlugin };
-export type { AllChartTypes, AxisColors, BarChartBuilder, CartesianChartBuilder, CartesianChartType, CartesianDataset, ChartBuilder, ChartWithFocus, Color, CommonAxes, CommonAxesSacels, CommonCartesian, CommonCartesianAxes, CommonCartesianTicks, CommonCartesianTitleConfig, CommonTicks, Constructor, CustomBarChartOptions, CustomCartesianDataset, CustomChartOptions, CustomLineChartOptions, CustomOptionPlugins, CustomPieChartOptions, CustomZoomType, DataLabels, DataLabelsContext, DatasetWithPrevColors, DeepPartial, DeepPartialCartesianAxes, DeepPartialPluginOptions, DeepPartialZoomType, FocusCallback, HtmlLegendOptions, LineChartBuilder, Mode, OriginalColors, PartialDataLabels, Position, ScaleWithOriginalColors, SettingOptions, ZoomRangeSliderColors, ZoomRangeSliderPlugin, ZoomRangeSliderVar };
+export { ArcChartWrapper, BarChartWrapper, CartesianChartWrapper, ChartFactory, ChartInstance, ChartToolBox, ChartTypes, ChartWrapper, CreateZoomRangeSlider, DoughnutChartWrapper, LineChartWrapper, T$, barScaleImgPlugin, blinkPlugin, changeSetting, chartMountPlugin, createDefaultBarOptions, createDefaultLineOptions, customLegend, T$ as default, defaultBarScales, defaultBarTooltipCallback, defaultLineScales, defaultLineTooltipCallback, doughnutCenterTextPlugin, loadingPlugin, makeCenterHtml, noDataPlugin, zoomRangeSlider, zoomResetPlugin };
+export type { AllChartTypes, ArcChartBuilder, ArcChartType, AxisColors, BarChartBuilder, CartesianChartBuilder, CartesianChartType, CartesianDataset, ChartBuilder, ChartWithFocus, Color, CommonAxes, CommonAxesSacels, CommonCartesian, CommonCartesianAxes, CommonCartesianTicks, CommonCartesianTitleConfig, CommonTicks, Constructor, CustomArcChartOptions, CustomBarChartOptions, CustomCartesianDataset, 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 };