stz-chart-maker 1.6.5 → 1.6.7

package/CHANGELOG.md

@@ -0,0 +1,52 @@
+# Changelog
+
+
+### [1.6.7] (2025-12-07)
+    -fix : backgroundColor, borderColor 속성 오류
+### [1.6.6] (2025-12-07) 
+    -feat : addData, setData, getData Method update , setPlugin 인자를 객체 하나에서 배열로 변경 
+### [1.6.5] (2025-11-25)
+    - fix : treeMapChart
+### [1.6.4] (2025-11-25)
+    - feat : CartesianChartWrapper method update 
+    - fix : ChartMountPlugin 관점 분리 
+### [1.6.3] (2025-11-24)
+    - feat : gantt method
+### [1.6.2] (2025-11-24) 
+    - fix : segmentImagePlugin 변경 ArcChartWrapper _group error
+### [1.6.1] (2025-11-24) 
+    - fix : ArcChartWrapper chartMountPlugin erorr fix 
+### [1.6.0] (2025-11-24) 
+    - feat : treemapChartWrapper 
+### [1.5.2] (2025-11-22)
+    - feat : segmentImage Method 
+### [1.5.1] (2025-11-17)
+    - feat : chart Img Function 
+### [1.5.0] (2025-11-16)
+    - fix : configLoader.ts 
+    - feat : pieChartWrapper 
+### [1.4.1] (2025-11-09)
+    - fix : Cannot access 'ChartWrapper' before initialization ReferenceError: Cannot access 'ChartWrapper' before initialization 문제 수정 ( configLoader.ts에서 바로 import  )
+### [1.4.0] (2025-11-09)
+     - feat : 설정파일 기능 확장 (CHART_COLOR, autoRegister 옵션 추가) 
+     - fix :  commonTypes 가독성 문제로 인한 분리
+### [1.3.3] (2025-11-08)
+    - feat : stz.config.js 설정파일 적용 기능 추가 
+### [1.3.1] (2025-11-03)
+    - feat : chartData 관련 엑세서 추가 각종 커스텀 데이터셋 키 추가 
+### [1.3.0] (2025-11-02)
+    - feat : ErrorShield 클래스 추가, 커스텀 에러 핸들링 기능 구현
+### [1.2.6] (2025-11-01)
+    - fix : README 오타 수정
+    - feat : sparkline 차트 클래스 추가
+### [1.2.5] (2025-10-25)
+    - feat : ChartWrapper class setTitle , setLegned cartesian class setBackgroundColor, setGrid 추가 , Doughnut setCenterText 추가
+### [1.2.2 ~ 1.2.4] (2025-10-19)
+    - fix : README 변경 
+### [1.2.1] (2025-10-19)
+    - fix : 라인 차트 오타 수정 
+    - feat: bar 차트 sparkBar 옵션, 메소드 추가 / Bubble 클래스 추가 / CustomError shield 추가
+### [1.1.0] (2025-10-10)
+    - feat : Doughnut 차트 클래스 추가
+    - fix : 각 클래스가 상속받는 interface 수정 
+### [1.0.20] (2025-10-09)

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 {