stz-chart-maker 1.6.4 → 1.6.6

package/dist/index.d.ts

@@ -639,13 +639,13 @@ declare abstract class ChartWrapper<TType extends ChartType, TOptions extends Cu
     protected abstract configAop(config: any): any;
     abstract build(id?: string): ChartConfig;
     /**
-     * @description 플러그인을 추가합니다.
-     * @param plugin
+     * @description 플러그인을 추가합니다. 단일 플러그인 또는 플러그인 배열을 받을 수 있습니다.
+     * @param plugin - 단일 플러그인 또는 플러그인 배열
      * @param replaceIfExists
      * @Since 1.0.0
      * @category plugin
      */
-    setPlugin(plugin: any, replaceIfExists?: boolean): this;
+    setPlugin(plugin: any | any[], replaceIfExists?: boolean): this;
     /**
      * @Description 레거시 지원용 차트 설정 객체를 생성합니다.
      * @param {string} id
@@ -1079,6 +1079,37 @@ declare abstract class CartesianChartWrapper<TType extends CartesianChartType> e
      * @category Dataset
      */
     setDataset(uid: string, dataset: CustomCartesianDataset<TType>): this;
+    /**
+     * @description 데이터셋을 UID 또는 인덱스로 조회합니다.
+     * @param uidOrIndex - 데이터셋 UID(문자열) 또는 인덱스(숫자)
+     * @returns {CustomCartesianDataset<TType> | undefined}
+     * @throws {CustomError} 데이터셋이 없거나 찾을 수 없을 때 에러를 발생시킵니다.
+     * @since 1.6.6
+     * @category Dataset
+     * @example
+     * // UID로 조회
+     * const dataset = chart.getData('dataset-uid');
+     *
+     * // 인덱스로 조회
+     * const dataset = chart.getData(0);
+     */
+    getData(uidOrIndex: string | number): CustomCartesianDataset<TType> | undefined;
+    /**
+     * @description 데이터셋을 UID 또는 인덱스로 교체합니다.
+     * @param uidOrIndex - 데이터셋 UID(문자열) 또는 인덱스(숫자)
+     * @param dataset - 새로운 데이터셋
+     * @returns {this}
+     * @throws {CustomError} 데이터셋이 없거나 찾을 수 없을 때 에러를 발생시킵니다.
+     * @since 1.6.6
+     * @category Dataset
+     * @example
+     * // UID로 교체
+     * chart.setData('dataset-uid', { label: 'New Dataset', data: [...] });
+     *
+     * // 인덱스로 교체
+     * chart.setData(0, { label: 'New Dataset', data: [...] });
+     */
+    setData(uidOrIndex: string | number, dataset: CustomCartesianDataset<TType>): this;
     /**
      * @Beta
      * @description 새로운 데이터셋을 추가하고 고유 식별자(UID)를 반환합니다. 데이터셋 배열이 비어있으면 새로 생성합니다.
@@ -1111,6 +1142,34 @@ declare abstract class CartesianChartWrapper<TType extends CartesianChartType> e
      * chart.setBackgroundColor('#f0f0f0');
      */
     setBackgroundColor(color: string): this;
+    /**
+     * @description 데이터셋에 데이터 포인트를 추가합니다. time series인 경우 자동으로 시간 순서대로 정렬됩니다.
+     * @param datasetIndexOrData - 데이터셋 인덱스(숫자) 또는 추가할 데이터. 숫자가 아니면 데이터로 간주하고 마지막 데이터셋에 추가됩니다.
+     * @param data - 추가할 데이터 (단일 객체 또는 배열). 첫 번째 인자가 데이터인 경우 생략.
+     * @returns {this}
+     * @throws {CustomError} 데이터셋이 없거나 인덱스가 유효하지 않을 경우 에러를 발생시킵니다.
+     * @since 1.6.6
+     * @category Dataset
+     * @example
+     * // 마지막 데이터셋에 단일 데이터 추가
+     * chart.addData({ x: 10, y: 20 });
+     *
+     * // 마지막 데이터셋에 여러 데이터 추가
+     * chart.addData([{ x: 10, y: 20 }, { x: 30, y: 40 }]);
+     *
+     * // 특정 데이터셋(0번)에 데이터 추가
+     * chart.addData(0, { x: 10, y: 20 });
+     *
+     * // 특정 데이터셋(1번)에 여러 데이터 추가
+     * chart.addData(1, [{ x: 10, y: 20 }, { x: 30, y: 40 }]);
+     */
+    addData(datasetIndexOrData?: number | any | any[], data?: any | any[]): this;
+    /**
+     * @private
+     * @description x축이 time series인지 확인합니다.
+     * @returns {boolean}
+     */
+    private isTimeSeries;
 }
 
 declare class BarChartWrapper extends CartesianChartWrapper<'bar'> implements BarChartBuilder {
@@ -2093,9 +2152,9 @@ declare class PieChartWrapper extends ArcChartWrapper<'pie'> implements PieChart
  * ═════════════════════════════════════════════════════════════
  */
 
-declare class TreemapChartWrapper<DType = Record<string, unknown>> extends ChartWrapper<'treemap', CustomTreemapChartOptions> implements TreemapChartBuilder {
+declare class TreemapChartWrapper extends ChartWrapper<'treemap', CustomTreemapChartOptions> implements TreemapChartBuilder {
     private _chartId?;
-    constructor(type: 'treemap', labels: any, datasets: CustomTreemapDataset<DType>[], options?: CustomTreemapChartOptions, plugins?: Plugin$1);
+    constructor(type: 'treemap', labels: undefined, datasets: CustomTreemapDataset[], options?: CustomTreemapChartOptions, plugins?: Plugin$1);
     get chartId(): string;
     set chartId(value: string);
     protected normalize(): void;
@@ -2120,7 +2179,7 @@ declare class TreemapChartWrapper<DType = Record<string, unknown>> extends Chart
      * @since 1.0.0
      * @category Data
      */
-    setTreeData(data: DType[] | number[] | Record<string, unknown>): this;
+    setTreeData(data: Record<string, unknown>[] | number[] | Record<string, unknown>): this;
     /**
      * @description 색상을 결정하는 키를 설정합니다.
      * @param key - 색상 키