stz-chart-maker 1.5.1 → 1.6.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { ChartType, ChartDataset, GridLineOptions, FontSpec, Tick, PluginOptionsByType, ChartOptions, Chart, ChartEvent, ActiveElement, LegendOptions, Plugin as Plugin$1, TooltipItem, ChartTypeRegistry } from 'chart.js';
+import { ChartTypeRegistry, ChartType, ChartDataset, GridLineOptions, FontSpec, Tick, PluginOptionsByType, ChartOptions, Chart, ChartEvent, ActiveElement, LegendOptions, Plugin as Plugin$1, TooltipItem } from 'chart.js';
+import { TreemapControllerDatasetOptions } from 'chartjs-chart-treemap';
 import { ZoomPluginOptions } from 'chartjs-plugin-zoom/types/options';
 import { DeepPartial as DeepPartial$1 } from 'chart.js/dist/types/utils';
 
@@ -23,11 +24,24 @@ type Mode = 'default' | 'resize' | 'reset' | 'none' | 'hide' | 'show' | 'active'
 type CartesianChartType = 'line' | 'bar' | 'scatter' | 'bubble';
 type ArcChartType = 'doughnut' | 'pie';
 type RadialChartType = 'radar' | 'polarArea';
+type HierarchicalChartType = 'treemap';
 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 AllChartTypes = keyof ChartTypeRegistry;
+declare enum ChartTypes {
+    BAR = "bar",
+    LINE = "line",
+    DOUGHNUT = "doughnut",
+    PIE = "pie",
+    RADAR = "radar",
+    BUBBLE = "bubble",
+    SCATTER = "scatter",
+    TREEMAP = "treemap"
+}
+
 /**
  * ═════════════════════════════════════════════════════════════
  * 📄 FILE     : dataset.ts
@@ -43,6 +57,7 @@ type Override<T, U> = Omit<T, keyof U> & U;
  */
 
 interface DatasetExtensions {
+    label?: string;
     _aux?: any;
     _uid?: string;
     _group?: string | number;
@@ -52,7 +67,7 @@ interface DatasetExtensions {
     _groupLabel?: string;
     _toggleBehavior?: 'normal' | 'radio' | 'disabled';
 }
-type CustomChartDatasets<TType extends ChartType = ChartType> = ChartDataset<TType, (number | null)[]> & DatasetExtensions;
+type CustomChartDatasets<TType extends ChartType = ChartType> = ChartDataset<TType, any> & 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;
@@ -70,6 +85,10 @@ type CustomCartesianDataset<TType extends CartesianChartType = CartesianChartTyp
     image?: string;
     images?: string[];
 };
+type CustomTreemapDataset<DType = Record<string, unknown>> = Omit<TreemapControllerDatasetOptions<DType>, 'groups' | 'sumKeys'> & DatasetExtensions & {
+    groups?: string[];
+    sumKeys?: string[];
+};
 
 /**
  * ═════════════════════════════════════════════════════════════
@@ -253,6 +272,13 @@ type PartialDataLabels = Partial<DataLabels>;
  * ═════════════════════════════════════════════════════════════
  */
 
+interface SegmentImageConfig {
+    images: string[];
+    width?: number;
+    height?: number;
+    backgroundColor?: string;
+    borderRadius?: number;
+}
 interface SettingOptions {
     img: string;
     iconSize: {
@@ -351,6 +377,9 @@ type CustomLineChartOptions = CustomChartOptions<'line'>;
 type CustomBubbleChartOptions = CustomChartOptions<'bubble'>;
 type CustomPieChartOptions = CustomArcChartOptions<'pie'>;
 type CustomDoughnutChartOptions = CustomArcChartOptions<'doughnut'>;
+type CustomTreemapChartOptions = CustomChartOptions<'treemap'> & {
+    scales?: never;
+};
 type Constructor<TType extends ChartType, TInstance> = new (type: TType, labels: (string | number)[], datasets: any[], options?: CustomChartOptions<TType>, plugins?: []) => TInstance;
 
 /**
@@ -421,6 +450,7 @@ interface BarChartBuilder extends CartesianChartBuilder<'bar'> {
     setStacked(isStacked: boolean): this;
     setBarImg(axis: string): this;
     sparkBarChart(): this;
+    ganttChart(): this;
 }
 interface LineChartBuilder extends CartesianChartBuilder<'line'> {
     setFill(datasetIndex: number, enable: boolean, backgroundColor?: string): this;
@@ -460,6 +490,7 @@ interface ArcChartBuilder<TType extends ArcChartType> extends ChartBuilder<TType
     setAllBorderWidth(borderWidth: number): this;
     setBorderColor(datasetIndex: number, borderColor: string | string[]): this;
     setAllBorderColor(borderColor: string | string[]): this;
+    setSegmentImages(images: string[], config?: Partial<Omit<SegmentImageConfig, 'images'>>): this;
 }
 interface PieChartBuilder extends ArcChartBuilder<'pie'> {
     setSegmentColors(colors: string[]): this;
@@ -489,6 +520,15 @@ interface DoughnutChartBuilder extends ArcChartBuilder<'doughnut'> {
 }
 interface RadarChartBuilder extends ChartBuilder<'radar'> {
 }
+interface TreemapChartBuilder extends ChartBuilder<'treemap'> {
+    setTreeData(data: any[]): this;
+    setColorKey(key: string): this;
+    setLabelKey(key: string): this;
+    setValueKey(key: string): this;
+    setSpacing(spacing: number): this;
+    setBorderWidth(borderWidth: number): this;
+    setBorderColor(borderColor: string): this;
+}
 
 /**
  * ═════════════════════════════════════════════════════════════
@@ -536,10 +576,13 @@ type Types_CustomDoughnutChartOptions = CustomDoughnutChartOptions;
 type Types_CustomLineChartOptions = CustomLineChartOptions;
 type Types_CustomOptionPlugins<TType extends ChartType = ChartType> = CustomOptionPlugins<TType>;
 type Types_CustomPieChartOptions = CustomPieChartOptions;
+type Types_CustomTreemapChartOptions = CustomTreemapChartOptions;
+type Types_CustomTreemapDataset<DType = Record<string, unknown>> = CustomTreemapDataset<DType>;
 type Types_DeepPartial<T> = DeepPartial<T>;
 type Types_DeepPartialCartesianAxes = DeepPartialCartesianAxes;
 type Types_DeepPartialPluginOptions<T extends ChartType> = DeepPartialPluginOptions<T>;
 type Types_DoughnutChartBuilder = DoughnutChartBuilder;
+type Types_HierarchicalChartType = HierarchicalChartType;
 type Types_HtmlLegendOptions = HtmlLegendOptions;
 type Types_LineChartBuilder = LineChartBuilder;
 type Types_Mode = Mode;
@@ -548,9 +591,11 @@ type Types_PieChartBuilder = PieChartBuilder;
 type Types_Position = Position;
 type Types_RadarChartBuilder = RadarChartBuilder;
 type Types_RadialChartType = RadialChartType;
+type Types_SegmentImageConfig = SegmentImageConfig;
 type Types_SettingOptions = SettingOptions;
+type Types_TreemapChartBuilder = TreemapChartBuilder;
 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_Override as Override, 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_CustomTreemapChartOptions as CustomTreemapChartOptions, Types_CustomTreemapDataset as CustomTreemapDataset, Types_DeepPartial as DeepPartial, Types_DeepPartialCartesianAxes as DeepPartialCartesianAxes, Types_DeepPartialPluginOptions as DeepPartialPluginOptions, Types_DoughnutChartBuilder as DoughnutChartBuilder, Types_HierarchicalChartType as HierarchicalChartType, 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_SegmentImageConfig as SegmentImageConfig, Types_SettingOptions as SettingOptions, Types_TreemapChartBuilder as TreemapChartBuilder };
 }
 
 interface ChartConfig {
@@ -570,17 +615,18 @@ type ChartBuilderMap = {
     pie: PieChartBuilder;
     radar: ChartBuilder<'radar'>;
     polarArea: ChartBuilder<'polarArea'>;
+    treemap: TreemapChartBuilder;
 };
 declare abstract class ChartWrapper<TType extends ChartType, TOptions extends CustomChartOptions<TType> = CustomChartOptions<TType>> implements ChartBuilder<TType> {
     protected type: TType;
-    protected labels: (string | number)[];
+    protected labels: (string | number)[] | undefined;
     private _datasets;
     protected options: TOptions;
     protected plugins?: any | undefined;
     protected get datasets(): CustomChartDatasets<TType>[];
     protected set datasets(value: CustomChartDatasets<TType>[]);
     static registry: Map<string, Constructor<any, any>>;
-    constructor(type: TType, labels: (string | number)[], _datasets: CustomChartDatasets<TType>[], options: TOptions, plugins?: any | undefined);
+    constructor(type: TType, labels: (string | number)[] | undefined, _datasets: CustomChartDatasets<TType>[], options: TOptions, plugins?: any | undefined);
     static create<TType extends ChartType>(type: TType, labels: (string | number)[], datasets: CustomChartDatasets<TType>[], options?: CustomChartOptions<TType>, plugins?: Plugin$1): TType extends keyof ChartBuilderMap ? ChartBuilderMap[TType] : ChartBuilder<TType>;
     static register<TType extends ChartType, TInstance>(type: TType, wrapperClass: Constructor<TType, TInstance>): void;
     static has(type: ChartType): boolean;
@@ -1194,6 +1240,46 @@ declare class BarChartWrapper extends CartesianChartWrapper<'bar'> implements Ba
      * @beta (기능 테스트 중)
      */
     sparkBarChart(): this;
+    /**
+     * @description 간트차트 스타일을 적용합니다. 데이터의 x 값은 반드시 yyyy-mm-dd 포맷이어야 합니다.
+     * X축을 time scale로 설정하고, indexAxis를 'y'로 설정하여 horizontal bar chart로 표시합니다.
+     * 모든 dataset에 borderWidth: 1, borderSkipped: false가 자동으로 적용됩니다.
+     * @returns {this}
+     * @throws {CustomError} 데이터가 yyyy-mm-dd 포맷이 아닐 경우 INVALID_DATA_STRUCTURE 에러 발생
+     * @since 1.0.0
+     * @category options
+     * @example
+     * // 간트차트 데이터 형식 (배열):
+     * const datasets = [
+     *   {
+     *     label: 'Task 1',
+     *     data: [['2024-01-01', '2024-01-05']],
+     *     backgroundColor: 'rgba(255, 99, 132, 0.5)'
+     *   },
+     *   {
+     *     label: 'Task 2',
+     *     data: [['2024-01-03', '2024-01-08']],
+     *     backgroundColor: 'rgba(54, 162, 235, 0.5)'
+     *   }
+     * ];
+     *
+     * // 간트차트 데이터 형식 (객체):
+     * const datasets = [
+     *   {
+     *     label: 'Task 1',
+     *     data: [
+     *       { x: '2024-01-01', y: 0 },
+     *       { x: '2024-01-05', y: 0 }
+     *     ]
+     *   }
+     * ];
+     *
+     * const chart = ChartWrapper.create('bar', ['Task 1', 'Task 2'], datasets)
+     *   .ganttChart()
+     *   .build();
+     * @beta (기능 테스트 중)
+     */
+    ganttChart(): this;
 }
 
 declare class LineChartWrapper extends CartesianChartWrapper<'line'> implements LineChartBuilder {
@@ -1658,6 +1744,28 @@ declare abstract class ArcChartWrapper<TType extends ArcChartType> extends Chart
      * @beta
      */
     setAllBorderColor(borderColor: string | string[]): this;
+    /**
+     * @description 각 세그먼트에 이미지를 설정합니다.
+     * @param images - 이미지 URL 배열 (URL, Base64, SVG, Emoji 등)
+     * @param config - 이미지 설정 옵션
+     * @returns {this}
+     * @since 1.6.0
+     * @category Dataset
+     * @beta
+     * @example
+     * // URL 방식
+     * chart.setSegmentImages([
+     *   'https://example.com/icon1.png',
+     *   'https://example.com/icon2.png'
+     * ]);
+     *
+     * // 크기 조절
+     * chart.setSegmentImages(
+     *   ['image1.png', 'image2.png'],
+     *   { width: 40, height: 40, backgroundColor: 'transparent' }
+     * );
+     */
+    setSegmentImages(images: string[], config?: Partial<Omit<SegmentImageConfig, 'images'>>): this;
 }
 
 declare class DoughnutChartWrapper extends ArcChartWrapper<'doughnut'> implements DoughnutChartBuilder {
@@ -1961,6 +2069,110 @@ declare class PieChartWrapper extends ArcChartWrapper<'pie'> implements PieChart
     private generateGradientColors;
 }
 
+/**
+ * ═════════════════════════════════════════════════════════════
+ * 📄 FILE     : TreemapChartWrapper.ts
+ * 📁 PACKAGE  : chart-toolbox
+ * 👤 AUTHOR   : stz
+ * 🕒 CREATED  : 2025. 1. 23.
+ * ═════════════════════════════════════════════════════════════
+ * ═════════════════════════════════════════════════════════════
+ * 📝 DESCRIPTION
+ *   Treemap Chart 를 위한 래퍼 클래스
+ * ═════════════════════════════════════════════════════════════
+ * ═════════════════════════════════════════════════════════════
+ * 🔄 CHANGE LOG
+ *   - DATE : 2025/01/23 | Author : stz | 최초 생성
+ * ═════════════════════════════════════════════════════════════
+ */
+
+declare class TreemapChartWrapper<DType = Record<string, unknown>> extends ChartWrapper<'treemap', CustomTreemapChartOptions> implements TreemapChartBuilder {
+    private _chartId?;
+    constructor(type: 'treemap', datasets: CustomTreemapDataset<DType>[], options?: CustomTreemapChartOptions, plugins?: Plugin$1);
+    get chartId(): string;
+    set chartId(value: string);
+    protected normalize(): void;
+    protected mustHavePlugins(): {
+        id: string;
+        _tooltips: WeakMap<WeakKey, any>;
+        afterDraw(chart: any, args: any, options: any): void;
+        afterInit(chart: any, args: any, options: any): void;
+        beforeUpdate(chart: any, args: any, options: any): void;
+        _handleGroupVisibility(chart: any, datasets: any[]): void;
+        _handleLegendClick(e: any, legendItem: any, legend: any, toggleBehavior: string): void;
+        _setupLegendTooltip(chart: any): void;
+        _hitTestLegend(chart: any, x: number, y: number): any;
+        _showTooltip(chart: any, e: MouseEvent, tooltipContent: string | ((context: any) => string), legendItem: any): void;
+        _hideTooltip(chart: any): void;
+        afterDestroy(chart: any): void;
+    }[];
+    protected configAop(config: any): any;
+    /**
+     * @Description 차트 설정 객체를 생성합니다.
+     * @param id
+     * @returns {ChartConfig}
+     * @Since 1.0.0
+     * @category Chart
+     */
+    build(id?: string): ChartConfig;
+    /**
+     * @description treemap의 데이터를 설정합니다.
+     * @param data - 계층적 트리 데이터
+     * @returns {this}
+     * @since 1.0.0
+     * @category Data
+     */
+    setTreeData(data: DType[] | number[] | Record<string, unknown>): this;
+    /**
+     * @description 색상을 결정하는 키를 설정합니다.
+     * @param key - 색상 키
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     */
+    setColorKey(key: string): this;
+    /**
+     * @description 라벨을 표시할 키를 설정합니다.
+     * @param key - 라벨 키
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     */
+    setLabelKey(key: string): this;
+    /**
+     * @description 값을 결정하는 키를 설정합니다.
+     * @param key - 값 키
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     */
+    setValueKey(key: string): this;
+    /**
+     * @description 타일 간 간격을 설정합니다.
+     * @param spacing - 간격 (픽셀)
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     */
+    setSpacing(spacing: number): this;
+    /**
+     * @description 타일의 경계선 너비를 설정합니다.
+     * @param borderWidth - 경계선 너비
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     */
+    setBorderWidth(borderWidth: number): this;
+    /**
+     * @description 타일의 경계선 색상을 설정합니다.
+     * @param borderColor - 경계선 색상
+     * @returns {this}
+     * @since 1.0.0
+     * @category Options
+     */
+    setBorderColor(borderColor: string): this;
+}
+
 declare const noDataPlugin: {
     id: string;
     beforeUpdate: (chart: any) => void;
@@ -1972,18 +2184,6 @@ declare const zoomResetPlugin: {
     afterDraw(chart: any, args: any, options: any): void;
     afterEvent(chart: any, args: any): void;
 };
-declare function doughnutCenterTextPlugin(config: {
-    text: string | string[];
-    color?: string;
-    fontStyle?: string;
-    fontSize?: string;
-}): {
-    id: string;
-    afterInit(chart: Chart): void;
-    afterUpdate(chart: Chart): void;
-    updatePosition(chart: Chart): void;
-    destroy(chart: Chart): void;
-};
 declare const loadingPlugin: {
     id: string;
     beforeInit(chart: any, args: any, options: any): void;
@@ -2144,6 +2344,23 @@ declare const zoomRangeSlider: {
 };
 declare const CreateZoomRangeSlider: (colors?: ZoomRangeSliderColors) => ZoomRangeSliderPlugin;
 
+declare function doughnutCenterTextPlugin(config: {
+    text: string | string[];
+    color?: string;
+    fontStyle?: string;
+    fontSize?: string;
+}): {
+    id: string;
+    afterInit(chart: Chart): void;
+    afterUpdate(chart: Chart): void;
+    updatePosition(chart: Chart): void;
+    destroy(chart: Chart): void;
+};
+declare function segmentImagePlugin(config: SegmentImageConfig): {
+    id: string;
+    afterDatasetDraw(chart: Chart<"doughnut" | "pie">, args: any): void;
+};
+
 declare const defaultBarTooltipCallback: (context: TooltipItem<"bar">) => string;
 declare const defaultBarScales: CommonAxesSacels;
 declare const createDefaultBarOptions: (userOptions?: CustomBarChartOptions, defaultScales?: CommonAxesSacels) => CustomBarChartOptions;
@@ -2159,6 +2376,69 @@ declare const defaultBubbleScales: CommonAxesSacels;
 declare const createDefaultBubbleOptions: (userOptions?: CustomBubbleChartOptions, defaultScales?: CommonAxesSacels) => CustomBubbleChartOptions;
 declare const sparkBubbleOptions: CustomBubbleChartOptions;
 
+/**
+ * ═════════════════════════════════════════════════════════════
+ * 📄 FILE     : Doughnut.ts
+ * 📁 PACKAGE  : chart-toolbox
+ * 👤 AUTHOR   : stz
+ * 🕒 CREATED  : 25. 9. 28.
+ * ═════════════════════════════════════════════════════════════
+ * ═════════════════════════════════════════════════════════════
+ * 📝 DESCRIPTION
+ *   Doughnut 차트 기본 설정
+ * ═════════════════════════════════════════════════════════════
+ * ═════════════════════════════════════════════════════════════
+ * 🔄 CHANGE LOG
+ *   - DATE : 2025/09/28 | Author : stz | 최초 생성
+ * ═════════════════════════════════════════════════════════════
+ */
+
+declare const defaultDoughnutTooltipCallback: (context: TooltipItem<"doughnut">) => string;
+declare const createDefaultDoughnutOptions: (userOptions?: CustomDoughnutChartOptions) => CustomDoughnutChartOptions;
+
+/**
+ * ═════════════════════════════════════════════════════════════
+ * 📄 FILE     : Pie.ts
+ * 📁 PACKAGE  : chart-toolbox
+ * 👤 AUTHOR   : stz
+ * 🕒 CREATED  : 25. 11. 16.
+ * ═════════════════════════════════════════════════════════════
+ * ═════════════════════════════════════════════════════════════
+ * 📝 DESCRIPTION
+ *   Pie 차트 기본 설정
+ * ═════════════════════════════════════════════════════════════
+ * ═════════════════════════════════════════════════════════════
+ * 🔄 CHANGE LOG
+ *   - DATE : 2025/11/16 | Author : stz | 최초 생성
+ * ═════════════════════════════════════════════════════════════
+ */
+
+declare const defaultPieTooltipCallback: (context: TooltipItem<"pie">) => string;
+declare const createDefaultPieOptions: (userOptions?: CustomPieChartOptions) => CustomPieChartOptions;
+
+/**
+ * ═════════════════════════════════════════════════════════════
+ * 📄 FILE     : Treemap.ts
+ * 📁 PACKAGE  : chart-toolbox
+ * 👤 AUTHOR   : stz
+ * 🕒 CREATED  : 2025. 1. 23.
+ * ═════════════════════════════════════════════════════════════
+ * ═════════════════════════════════════════════════════════════
+ * 📝 DESCRIPTION
+ *   Treemap 차트 기본 설정
+ * ═════════════════════════════════════════════════════════════
+ * ═════════════════════════════════════════════════════════════
+ * 🔄 CHANGE LOG
+ *   - DATE : 2025/01/23 | Author : stz | 최초 생성
+ * ═════════════════════════════════════════════════════════════
+ */
+
+declare const defaultTreemapTooltipCallback: {
+    title(items: any[]): any;
+    label(item: any): string;
+};
+declare const createDefaultTreemapOptions: (userOptions?: CustomTreemapChartOptions) => CustomTreemapChartOptions;
+
 declare const LocalDefaults_CreateZoomRangeSlider: typeof CreateZoomRangeSlider;
 declare const LocalDefaults_barScaleImgPlugin: typeof barScaleImgPlugin;
 declare const LocalDefaults_blinkPlugin: typeof blinkPlugin;
@@ -2166,18 +2446,25 @@ declare const LocalDefaults_changeSetting: typeof changeSetting;
 declare const LocalDefaults_chartMountPlugin: typeof chartMountPlugin;
 declare const LocalDefaults_createDefaultBarOptions: typeof createDefaultBarOptions;
 declare const LocalDefaults_createDefaultBubbleOptions: typeof createDefaultBubbleOptions;
+declare const LocalDefaults_createDefaultDoughnutOptions: typeof createDefaultDoughnutOptions;
 declare const LocalDefaults_createDefaultLineOptions: typeof createDefaultLineOptions;
+declare const LocalDefaults_createDefaultPieOptions: typeof createDefaultPieOptions;
+declare const LocalDefaults_createDefaultTreemapOptions: typeof createDefaultTreemapOptions;
 declare const LocalDefaults_customLegend: typeof customLegend;
 declare const LocalDefaults_defaultBarScales: typeof defaultBarScales;
 declare const LocalDefaults_defaultBarTooltipCallback: typeof defaultBarTooltipCallback;
 declare const LocalDefaults_defaultBubbleScales: typeof defaultBubbleScales;
 declare const LocalDefaults_defaultBubbleTooltipCallback: typeof defaultBubbleTooltipCallback;
+declare const LocalDefaults_defaultDoughnutTooltipCallback: typeof defaultDoughnutTooltipCallback;
 declare const LocalDefaults_defaultLineScales: typeof defaultLineScales;
 declare const LocalDefaults_defaultLineTooltipCallback: typeof defaultLineTooltipCallback;
+declare const LocalDefaults_defaultPieTooltipCallback: typeof defaultPieTooltipCallback;
+declare const LocalDefaults_defaultTreemapTooltipCallback: typeof defaultTreemapTooltipCallback;
 declare const LocalDefaults_doughnutCenterTextPlugin: typeof doughnutCenterTextPlugin;
 declare const LocalDefaults_loadingPlugin: typeof loadingPlugin;
 declare const LocalDefaults_makeCenterHtml: typeof makeCenterHtml;
 declare const LocalDefaults_noDataPlugin: typeof noDataPlugin;
+declare const LocalDefaults_segmentImagePlugin: typeof segmentImagePlugin;
 declare const LocalDefaults_sparkBarOptions: typeof sparkBarOptions;
 declare const LocalDefaults_sparkBubbleOptions: typeof sparkBubbleOptions;
 declare const LocalDefaults_sparkLineOptions: typeof sparkLineOptions;
@@ -2192,18 +2479,25 @@ declare namespace LocalDefaults {
     LocalDefaults_chartMountPlugin as chartMountPlugin,
     LocalDefaults_createDefaultBarOptions as createDefaultBarOptions,
     LocalDefaults_createDefaultBubbleOptions as createDefaultBubbleOptions,
+    LocalDefaults_createDefaultDoughnutOptions as createDefaultDoughnutOptions,
     LocalDefaults_createDefaultLineOptions as createDefaultLineOptions,
+    LocalDefaults_createDefaultPieOptions as createDefaultPieOptions,
+    LocalDefaults_createDefaultTreemapOptions as createDefaultTreemapOptions,
     LocalDefaults_customLegend as customLegend,
     LocalDefaults_defaultBarScales as defaultBarScales,
     LocalDefaults_defaultBarTooltipCallback as defaultBarTooltipCallback,
     LocalDefaults_defaultBubbleScales as defaultBubbleScales,
     LocalDefaults_defaultBubbleTooltipCallback as defaultBubbleTooltipCallback,
+    LocalDefaults_defaultDoughnutTooltipCallback as defaultDoughnutTooltipCallback,
     LocalDefaults_defaultLineScales as defaultLineScales,
     LocalDefaults_defaultLineTooltipCallback as defaultLineTooltipCallback,
+    LocalDefaults_defaultPieTooltipCallback as defaultPieTooltipCallback,
+    LocalDefaults_defaultTreemapTooltipCallback as defaultTreemapTooltipCallback,
     LocalDefaults_doughnutCenterTextPlugin as doughnutCenterTextPlugin,
     LocalDefaults_loadingPlugin as loadingPlugin,
     LocalDefaults_makeCenterHtml as makeCenterHtml,
     LocalDefaults_noDataPlugin as noDataPlugin,
+    LocalDefaults_segmentImagePlugin as segmentImagePlugin,
     LocalDefaults_sparkBarOptions as sparkBarOptions,
     LocalDefaults_sparkBubbleOptions as sparkBubbleOptions,
     LocalDefaults_sparkLineOptions as sparkLineOptions,
@@ -2232,18 +2526,6 @@ declare class ChartInstance {
     static resize(id: string): void;
 }
 
-type AllChartTypes = keyof ChartTypeRegistry;
-declare enum ChartTypes {
-    BAR = "bar",
-    LINE = "line",
-    DOUGHNUT = "doughnut",
-    PIE = "pie",
-    RADAR = "radar",
-    BUBBLE = "bubble",
-    SCATTER = "scatter",
-    TREE = "tree"
-}
-
 interface StzConfig {
     errorLogging?: boolean;
     silentMode?: boolean;
@@ -2356,6 +2638,7 @@ declare const T$: {
     readonly ArcChartWrapper: typeof ArcChartWrapper;
     readonly DoughnutChartWrapper: typeof DoughnutChartWrapper;
     readonly PieChartWrapper: typeof PieChartWrapper;
+    readonly TreemapChartWrapper: typeof TreemapChartWrapper;
     readonly defaultTypes: typeof Types;
     readonly defaultsOptions: typeof LocalDefaults;
     readonly toolBox: {
@@ -2364,5 +2647,5 @@ declare const T$: {
     };
 };
 
-export { ArcChartWrapper, BarChartWrapper, BubbleChartWrapper, CartesianChartWrapper, ChartFactory, ChartInstance, ChartToolBox, ChartTypes, ChartWrapper, CreateZoomRangeSlider, DoughnutChartWrapper, LineChartWrapper, PieChartWrapper, T$, barScaleImgPlugin, blinkPlugin, changeSetting, chartMountPlugin, createDefaultBarOptions, createDefaultBubbleOptions, createDefaultLineOptions, customLegend, T$ as default, defaultBarScales, defaultBarTooltipCallback, defaultBubbleScales, defaultBubbleTooltipCallback, defaultLineScales, defaultLineTooltipCallback, doughnutCenterTextPlugin, downloadChartAsImage, downloadChartAsImageByInstance, getChartAsBase64, getChartAsBase64ByInstance, getChartAsBlob, getChartAsBlobByInstance, loadingPlugin, makeCenterHtml, noDataPlugin, setChartConfig, sparkBarOptions, sparkBubbleOptions, sparkLineOptions, zoomRangeSlider, zoomResetPlugin };
-export type { Align, AllChartTypes, ArcChartBuilder, ArcChartType, ArcDataset, AxisColors, BarChartBuilder, BubbleChartBuilder, CartesianChartBuilder, CartesianChartType, CartesianDataset, ChartBuilder, ChartImageExportOptions, 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, StzConfig, ZoomRangeSliderColors, ZoomRangeSliderPlugin, ZoomRangeSliderVar };
+export { ArcChartWrapper, BarChartWrapper, BubbleChartWrapper, CartesianChartWrapper, ChartFactory, ChartInstance, ChartToolBox, ChartTypes, ChartWrapper, CreateZoomRangeSlider, DoughnutChartWrapper, LineChartWrapper, PieChartWrapper, T$, TreemapChartWrapper, barScaleImgPlugin, blinkPlugin, changeSetting, chartMountPlugin, createDefaultBarOptions, createDefaultBubbleOptions, createDefaultDoughnutOptions, createDefaultLineOptions, createDefaultPieOptions, createDefaultTreemapOptions, customLegend, T$ as default, defaultBarScales, defaultBarTooltipCallback, defaultBubbleScales, defaultBubbleTooltipCallback, defaultDoughnutTooltipCallback, defaultLineScales, defaultLineTooltipCallback, defaultPieTooltipCallback, defaultTreemapTooltipCallback, doughnutCenterTextPlugin, downloadChartAsImage, downloadChartAsImageByInstance, getChartAsBase64, getChartAsBase64ByInstance, getChartAsBlob, getChartAsBlobByInstance, loadingPlugin, makeCenterHtml, noDataPlugin, segmentImagePlugin, setChartConfig, sparkBarOptions, sparkBubbleOptions, sparkLineOptions, zoomRangeSlider, zoomResetPlugin };
+export type { Align, AllChartTypes, ArcChartBuilder, ArcChartType, ArcDataset, AxisColors, BarChartBuilder, BubbleChartBuilder, CartesianChartBuilder, CartesianChartType, CartesianDataset, ChartBuilder, ChartImageExportOptions, ChartWithFocus, Color, CommonAxes, CommonAxesSacels, CommonCartesian, CommonCartesianAxes, CommonCartesianLegendConfig, CommonCartesianTicks, CommonCartesianTitleConfig, CommonTicks, Constructor, CustomArcChartOptions, CustomBarChartOptions, CustomBubbleChartOptions, CustomCartesianDataset, CustomChartDatasets, CustomChartOptions, CustomDoughnutChartOptions, CustomLineChartOptions, CustomOptionPlugins, CustomPieChartOptions, CustomTreemapChartOptions, CustomTreemapDataset, CustomZoomType, DataLabels, DataLabelsContext, DatasetWithPrevColors, DeepPartial, DeepPartialCartesianAxes, DeepPartialPluginOptions, DeepPartialZoomType, DoughnutChartBuilder, FocusCallback, HierarchicalChartType, HtmlLegendOptions, LineChartBuilder, Mode, OriginalColors, Override, PartialDataLabels, PieChartBuilder, Position, RadarChartBuilder, RadialChartType, ScaleWithOriginalColors, SegmentImageConfig, SettingOptions, StzConfig, TreemapChartBuilder, ZoomRangeSliderColors, ZoomRangeSliderPlugin, ZoomRangeSliderVar };