open-grid 1.2.0 → 1.2.1

package/dist/types/core/TriggerManager.d.ts

@@ -1,9 +1,55 @@
 import { TriggerContext, TriggerHandler, TriggerEvent } from './types.js';
+/**
+ * before/after 트리거 훅 레지스트리. / Registry for before/after trigger hooks.
+ *
+ * 그리드 연산(`operation`) 앞뒤로 사용자 핸들러를 실행한다. `before:*` 훅은
+ * 컨텍스트를 `cancel()` 하여 연산을 취소할 수 있고, `after:*` 훅 뒤에는 `complete`
+ * 훅이 추가로 실행된다.
+ * / Runs user handlers around grid operations. A `before:*` hook may cancel the
+ * operation via `ctx.cancel()`; after any `after:*` hook, registered `complete`
+ * hooks also fire.
+ */
 export declare class TriggerManager {
     private _triggers;
+    /**
+     * 트리거 이벤트에 핸들러를 등록한다. / Register a handler for a trigger event.
+     *
+     * @param event - 트리거 이벤트명(예: `before:setValue`) / Trigger event name (e.g. `before:setValue`)
+     * @param handler - 실행할 핸들러 / Handler to run
+     */
     add(event: TriggerEvent | string, handler: TriggerHandler): void;
+    /**
+     * 등록된 핸들러를 제거한다. / Remove a previously registered handler.
+     *
+     * @param event - 트리거 이벤트명 / Trigger event name
+     * @param handler - 제거할 핸들러(등록 시와 동일 참조) / Handler to remove (same reference used at registration)
+     */
     remove(event: TriggerEvent | string, handler: TriggerHandler): void;
+    /**
+     * 특정 이벤트 또는 전체 트리거를 해제한다. / Clear one event's triggers, or all of them.
+     *
+     * @param event - 지우려는 이벤트명. 생략하면 전체 삭제 / Event to clear; omit to clear everything
+     */
     clear(event?: TriggerEvent | string): void;
+    /**
+     * 트리거 실행용 컨텍스트 객체를 생성한다. / Build a context object for trigger execution.
+     *
+     * @param operation - 연산 이름 / Operation name
+     * @param args - 연산 인자 배열 / Operation argument array
+     * @returns `cancel()` 로 취소 가능한 트리거 컨텍스트 / A trigger context cancellable via `cancel()`
+     */
     mkCtx(operation: string, args: any[]): TriggerContext;
+    /**
+     * 이벤트에 등록된 핸들러를 순차 실행한다. / Run handlers registered for an event, in order.
+     *
+     * `before:*` 훅 중 하나라도 `ctx.cancel()` 을 호출하면 즉시 중단하고 `false` 를
+     * 반환한다. `after:*` 이벤트는 완료 후 `complete` 훅도 실행한다.
+     * / If any `before:*` hook calls `ctx.cancel()`, execution stops immediately and
+     * returns `false`. For `after:*` events, `complete` hooks also run afterward.
+     *
+     * @param event - 실행할 이벤트명 / Event name to run
+     * @param ctx - 트리거 컨텍스트 / Trigger context
+     * @returns 취소되지 않았으면 `true` / `true` unless the operation was cancelled
+     */
     exec(event: string, ctx: TriggerContext): boolean;
 }

package/dist/types/core/WorksheetManager.d.ts

@@ -1,7 +1,18 @@
 import { ColumnDef, WorksheetState } from './types.js';
+/** 시트 전환 시 호출되는 콜백. / Callback invoked when the active sheet switches. */
 export type SwitchCallback<T> = (name: string, state: WorksheetState<T>) => void;
 /** i18n: 탭 UI aria 해석기(주입 없으면 전역 t). / i18n: tab-UI aria resolver (global t when not injected). */
 export type WorksheetT = (key: string, params?: Record<string, string | number>) => string;
+/**
+ * 그리드 다중 워크시트(탭) 관리자. / Manages the grid's multiple worksheets (tabs).
+ *
+ * 시트별로 독립적인 `columns`/`data` 를 `Map` 으로 보유하고, 탭 클릭 시
+ * `onSwitch` 콜백을 통해 `OpenGrid.setData`/`applyColumns` 로 화면을 전환시킨다.
+ * 탭 UI는 그리드 컨테이너 하단에 `.og-sheet-tabs` 영역으로 삽입된다.
+ * / Holds independent `columns`/`data` per sheet in a `Map`; a tab click drives the
+ * `onSwitch` callback, which the caller uses to run `OpenGrid.setData`/`applyColumns`.
+ * The tab UI is inserted as a `.og-sheet-tabs` region at the bottom of the grid container.
+ */
 export declare class WorksheetManager<T extends Record<string, any> = any> {
     private _sheets;
     private _active;
@@ -9,18 +20,66 @@ export declare class WorksheetManager<T extends Record<string, any> = any> {
     private _onSwitch;
     private _t;
     constructor(container: HTMLElement, onSwitch: SwitchCallback<T>, t?: WorksheetT);
+    /**
+     * 새 시트를 추가한다. / Add a new sheet.
+     *
+     * 첫 번째로 추가되는 시트는 자동으로 활성화된다. / The first sheet ever added is auto-activated.
+     *
+     * @param name - 시트 이름(고유해야 함) / Sheet name (must be unique)
+     * @param columns - 시트 컬럼 정의(기본 빈 배열) / Sheet column definitions (default empty array)
+     * @param data - 시트 초기 데이터(기본 빈 배열) / Initial sheet data (default empty array)
+     */
     add(name: string, columns?: ColumnDef<T>[], data?: T[]): void;
+    /**
+     * 시트를 제거한다. / Remove a sheet.
+     *
+     * 마지막 남은 시트는 제거할 수 없다(예외 발생). 활성 시트를 제거하면 남은 시트 중
+     * 첫 번째로 자동 전환한다. / The last remaining sheet cannot be removed (throws).
+     * Removing the active sheet auto-switches to the first remaining sheet.
+     *
+     * @param name - 제거할 시트 이름 / Name of the sheet to remove
+     */
     remove(name: string): void;
+    /**
+     * 시트 이름을 변경한다. / Rename a sheet.
+     *
+     * 삽입 순서(`Map` 순회 순서) 유지를 위해 내부적으로 시트 맵을 재구성한다.
+     * / Internally rebuilds the sheet map to preserve insertion order (`Map` iteration order).
+     *
+     * @param oldName - 기존 시트 이름 / Current sheet name
+     * @param newName - 새 시트 이름(고유해야 함) / New sheet name (must be unique)
+     */
     rename(oldName: string, newName: string): void;
+    /**
+     * 지정 시트를 활성화하고 `onSwitch` 콜백을 실행한다. / Activate the given sheet and invoke the `onSwitch` callback.
+     *
+     * @param name - 활성화할 시트 이름 / Name of the sheet to activate
+     */
     switch(name: string): void;
+    /**
+     * 시트 상태를 조회한다. / Look up a sheet's state.
+     *
+     * @param name - 조회할 시트 이름 / Name of the sheet to look up
+     * @returns 시트 상태, 없으면 `undefined` / The sheet state, or `undefined`
+     */
     get(name: string): WorksheetState<T> | undefined;
+    /** 등록된 모든 시트 이름 목록(삽입 순서). / Names of all registered sheets, in insertion order. */
     getNames(): string[];
+    /** 현재 활성 시트 이름. / Name of the currently active sheet. */
     getActive(): string;
-    /** 현재 활성 시트의 data를 갱신 (그리드 편집 동기화용) */
+    /**
+     * 지정 시트의 데이터를 갱신한다(그리드 편집 동기화용). / Update a sheet's data (for syncing grid edits back).
+     *
+     * @param name - 갱신할 시트 이름 / Name of the sheet to update
+     * @param data - 새 데이터 배열 / New data array
+     */
     syncData(name: string, data: T[]): void;
+    /** 탭 바 DOM 을 제거한다. / Remove the tab-bar DOM. */
     destroy(): void;
+    /** @internal 탭 바 컨테이너를 생성해 그리드 컨테이너에 삽입한다. / Creates the tab-bar container and appends it to the grid container. */
     private _buildTabBar;
+    /** @internal 탭 바를 전체 재렌더한다(시트 목록 + '+' 버튼). / Fully re-renders the tab bar (sheet list + '+' button). */
     private _renderTabs;
-    /** 탭 더블클릭 → input으로 전환해 이름 변경 */
+    /** @internal 탭 더블클릭 → input으로 전환해 이름 변경. / Double-click on a tab switches it to an input for inline rename. */
     private _startRename;
 }

package/dist/types/core/XmlConverter.d.ts

@@ -1,74 +1,104 @@
 /**
  * XmlConverter — XML ↔ 그리드 데이터 양방향 변환 유틸리티.
+ * / XmlConverter — bidirectional XML ↔ grid-data conversion utility.
  *
- * 지원 포맷:
+ * 지원 포맷 / Supported formats:
  *   A. Element 방식  <row><name>홍길동</name></row>
  *   B. Attribute 방식  <row name="홍길동" />
  *   C. SAP BAPI XML 응답  <RETURN><TYPE>S</TYPE><BELNR>...</BELNR></RETURN>
  *   D. SAP IDoc XML  <IDOC><E1HEADER SEGMENT="1"><BUKRS>1000</BUKRS></IDOC>
  *
  * 외부 의존성 없음 — 브라우저 내장 DOMParser 사용.
+ * / No external dependency — uses the browser's built-in DOMParser.
  */
+/** XML → 데이터 파싱 옵션. / Options for parsing XML into data. */
 export interface XmlParseOptions {
-    /** 루트 엘리먼트 태그명 (생략 시 문서 루트 자동 사용) */
+    /** 루트 엘리먼트 태그명. 생략 시 문서 루트 자동 사용. / Root element tag name; falls back to the document root when omitted. */
     rootTag?: string;
-    /** 행 엘리먼트 태그명 (생략 시 루트의 첫 번째 자식 자동 감지) */
+    /** 행 엘리먼트 태그명. 생략 시 루트의 첫 번째 자식 자동 감지. / Row element tag name; auto-detected from the root's first child when omitted. */
     rowTag?: string;
-    /** 값 추출 방식: 'element' | 'attribute' | 'auto'(기본) */
+    /** 값 추출 방식: 'element' | 'attribute' | 'auto'(기본). / Value extraction mode: 'element' | 'attribute' | 'auto' (default). @defaultValue 'auto' */
     mode?: 'element' | 'attribute' | 'auto';
-    /** XML 태그명 → 그리드 field명 매핑 (생략 시 태그명 그대로 사용) */
+    /** XML 태그명 → 그리드 field명 매핑. 생략 시 태그명 그대로 사용. / XML tag name → grid field name map; tag names are used as-is when omitted. */
     fieldMap?: Record<string, string>;
-    /** 텍스트 값 앞뒤 공백 제거 (기본 true) */
+    /** 텍스트 값 앞뒤 공백 제거. 기본 true. / Trim whitespace around text values. Default true. @defaultValue true */
     trim?: boolean;
 }
+/** 데이터 → XML 직렬화 옵션. / Options for serializing data into XML. */
 export interface XmlStringifyOptions {
-    /** 루트 태그명 (기본 'rows') */
+    /** 루트 태그명. 기본 'rows'. / Root tag name. Default 'rows'. @defaultValue 'rows' */
     rootTag?: string;
-    /** 행 태그명 (기본 'row') */
+    /** 행 태그명. 기본 'row'. / Row tag name. Default 'row'. @defaultValue 'row' */
     rowTag?: string;
-    /** 출력 방식: 'element'(기본) | 'attribute' */
+    /** 출력 방식: 'element'(기본) | 'attribute'. / Output mode: 'element' (default) | 'attribute'. @defaultValue 'element' */
     mode?: 'element' | 'attribute';
-    /** 그리드 field명 → XML 태그명 매핑 */
+    /** 그리드 field명 → XML 태그명 매핑. / Grid field name → XML tag name map. */
     fieldMap?: Record<string, string>;
-    /** XML 선언부 포함 여부 (기본 true) */
+    /** XML 선언부 포함 여부. 기본 true. / Whether to include the XML declaration. Default true. @defaultValue true */
     declaration?: boolean;
-    /** 들여쓰기 공백 수 (기본 2) */
+    /** 들여쓰기 공백 수. 기본 2. / Indentation space count. Default 2. @defaultValue 2 */
     indent?: number;
-    /** null/undefined 처리 문자열 (기본 '') */
+    /** null/undefined 처리 문자열. 기본 ''. / String used for null/undefined values. Default ''. @defaultValue '' */
     nullAs?: string;
-    /** 출력에서 제외할 필드 목록 */
+    /** 출력에서 제외할 필드 목록. / Field names to exclude from the output. */
     excludeFields?: string[];
 }
+/** SAP XML 파싱 결과 구조. / Result structure of SAP XML parsing. */
 export interface SapParseResult {
+    /** 문서 헤더(DOCUMENTHEADER) 필드 맵. / Document header (DOCUMENTHEADER) field map. */
     header: Record<string, string>;
+    /** 라인 아이템 행 배열. / Line-item row array. */
     items: Record<string, string>[];
+    /** RETURN 메시지 행 배열(복수). / RETURN message rows (may be multiple). */
     returns: Record<string, string>[];
+    /** 파싱에 사용한 원본 Document(선택). / The source Document used for parsing (optional). */
     raw?: Document;
 }
+/**
+ * XML ↔ 그리드 데이터 변환기(정적 메서드 모음). / XML ↔ grid-data converter (static methods).
+ *
+ * @example
+ * const rows = XmlConverter.parse('<rows><row><name>Kim</name></row></rows>');
+ * const xml  = XmlConverter.stringify(rows);
+ */
 export declare class XmlConverter {
     /**
-     * XML 문자열을 파싱하여 그리드 데이터 배열로 변환.
-     * Element / Attribute 방식 자동 감지.
+     * XML 문자열을 파싱하여 그리드 데이터 배열로 변환. Element / Attribute 방식 자동 감지.
+     * / Parse an XML string into a grid-data array. Auto-detects element vs. attribute style.
      *
-     * @throws XML 파싱 오류 시 Error 발생
+     * @param xml - 파싱할 XML 문자열 / XML string to parse
+     * @param options - 파싱 옵션 / Parse options
+     * @returns 행 객체 배열 / Array of row objects
+     * @throws XML 파싱 오류 시 Error 발생 / Throws an Error on XML parse failure
      */
     static parse(xml: string, options?: XmlParseOptions): Record<string, any>[];
     /**
-     * 그리드 데이터 배열을 XML 문자열로 직렬화.
+     * 그리드 데이터 배열을 XML 문자열로 직렬화. / Serialize a grid-data array into an XML string.
+     *
+     * @param data - 직렬화할 행 배열 / Row array to serialize
+     * @param options - 직렬화 옵션 / Serialize options
+     * @returns XML 문자열 / XML string
      */
     static stringify(data: Record<string, any>[], options?: XmlStringifyOptions): string;
     /**
      * SAP BAPI XML 응답을 파싱하여 { header, items, returns } 구조로 반환.
+     * / Parse a SAP BAPI XML response into a { header, items, returns } structure.
      *
-     * 지원 패턴:
+     * 지원 패턴 / Supported patterns:
      *   <DOCUMENTHEADER>...</DOCUMENTHEADER>
      *   <ACCOUNTGL><ITEM>...</ITEM></ACCOUNTGL>
      *   <RETURN><TYPE>S</TYPE><MESSAGE>...</MESSAGE></RETURN>
+     *
+     * @param xml - SAP BAPI XML 응답 문자열 / SAP BAPI XML response string
+     * @returns 파싱 결과 구조 / Parsed result structure
      */
     static parseSap(xml: string): SapParseResult;
     /**
-     * BAPI 페이로드 객체를 SAP XML 형식으로 직렬화.
-     * sapGenPayload()의 결과 또는 단일 document 객체를 받음.
+     * BAPI 페이로드 객체를 SAP XML 형식으로 직렬화. sapGenPayload() 결과 또는 단일 document 객체를 받음.
+     * / Serialize a BAPI payload object into SAP XML. Accepts a sapGenPayload() result or a single document object.
+     *
+     * @param payload - BAPI 페이로드 객체 / BAPI payload object
+     * @returns SAP XML 문자열 / SAP XML string
      */
     static stringifySap(payload: {
         BAPI_FUNCTION?: string;
@@ -77,8 +107,11 @@ export declare class XmlConverter {
         [key: string]: any;
     }): string;
     /**
-     * sapGenPayload()의 { totalDocuments, documents[] } 결과를
-     * 다건 BAPI XML로 직렬화.
+     * sapGenPayload() 의 { totalDocuments, documents[] } 결과를 다건 BAPI XML 로 직렬화.
+     * / Serialize a sapGenPayload() { totalDocuments, documents[] } result into a multi-document BAPI XML.
+     *
+     * @param payload - documents 배열을 담은 페이로드 / Payload holding the documents array
+     * @returns 다건 BAPI XML 문자열 / Multi-document BAPI XML string
      */
     static stringifySapBatch(payload: {
         documents: any[];

package/dist/types/core/chart/types.d.ts

@@ -7,13 +7,20 @@ import { CellRange } from '../types.js';
  * 폴백 렌더된다(CanvasAdapter._computeGeometry). 하위호환을 위해 타입 자체는 유지한다.
  */
 export type ChartType = 'bar' | 'line' | 'area' | 'pie' | 'doughnut' | 'bar-stacked' | 'bar-grouped';
+/** 시리즈(컬럼) 명세. / Series (column) spec. */
 export interface ChartSeriesSpec {
+    /** 값 컬럼 field 명. / Value column field name. */
     field: string;
+    /** 범례 라벨(기본 = 컬럼 header/field). / Legend label (default = column header/field). */
     name?: string;
+    /** 시리즈 색. / Series color. */
     color?: string;
+    /** 색 외 구분 패턴. / Non-color distinction pattern. */
     pattern?: ChartSeries['pattern'];
+    /** 시리즈별 렌더 타입(혼합 차트). / Per-series render type (mixed charts). */
     type?: 'bar' | 'line' | 'area';
 }
+/** 차트 데이터 소스(범위/선택/체크/전체/컬럼 지정). / Chart data source (range/selection/checked/all/explicit columns). */
 export type ChartSource = {
     kind: 'range';
     range?: CellRange;
@@ -28,61 +35,92 @@ export type ChartSource = {
     category?: string;
     series: Array<string | ChartSeriesSpec>;
 };
+/** 카테고리 집계 연산. / Category aggregation operation. */
 export type ChartAggregateOp = 'sum' | 'avg' | 'count' | 'min' | 'max';
+/** 집계 연산 또는 커스텀 리듀서. / An aggregation op or a custom reducer. */
 export type ChartAggregate = ChartAggregateOp | ((values: number[], category: string) => number);
+/** 접근성(SR) 테이블 모델 — 스크린리더 폴백. / Accessibility (SR) table model — screen-reader fallback. */
 export interface A11yTableModel {
-    /** aria-label 요약 캡션 */
+    /** aria-label 요약 캡션. / aria-label summary caption. */
     caption: string;
     /** ['category', ...series names] */
     colHeaders: string[];
-    /** [category, v1, v2, ...] — locale 포맷 문자열 */
+    /** [category, v1, v2, ...] — locale 포맷 문자열. / [category, v1, v2, ...] — locale-formatted strings. */
     rows: string[][];
 }
+/** 차트 시리즈(정규화된 값 배열). / Chart series (normalized value array). */
 export interface ChartSeries {
-    /** 범례 라벨(기본값 = 원본 컬럼 header/field) */
+    /** 범례 라벨(기본값 = 원본 컬럼 header/field). / Legend label (default = source column header/field). */
     name: string;
-    /** categories 와 동일 순서로 정렬. 결측=null */
+    /** categories 와 동일 순서로 정렬. 결측=null. / Aligned to categories order; missing = null. */
     data: Array<number | null>;
+    /** 시리즈 색. / Series color. */
     color?: string;
-    /** 색 외 구분(HANMS-19) */
+    /** 색 외 구분(HANMS-19). / Non-color distinction (HANMS-19). */
     pattern?: 'solid' | 'hatch' | 'dot' | 'cross';
 }
+/** 차트 데이터 모델 메타(출처·샘플링·집계 배지 정보). / Chart data model meta (source, sampling, aggregation badge info). */
 export interface ChartDataModelMeta {
+    /** 소스 종류. / Source kind. */
     sourceKind: ChartSource['kind'];
-    /** 원본 포인트(행) 수 */
+    /** 원본 포인트(행) 수. / Original point (row) count. */
     total: number;
-    /** LTTB 다운샘플 또는 category 집계로 축약됐는가 → 배지(§C) */
+    /** LTTB 다운샘플 또는 category 집계로 축약됐는가 → 배지(§C). / Whether reduced by LTTB downsample or category aggregation → badge (§C). */
     sampled: boolean;
+    /** 다운샘플 전 포인트 수. / Point count before downsampling. */
     sampledFrom?: number;
+    /** 다운샘플 후 포인트 수. / Point count after downsampling. */
     sampledTo?: number;
+    /** 적용된 집계 연산. / Applied aggregation op. */
     aggregatedOp?: 'sum' | 'avg' | 'count' | 'min' | 'max' | 'custom';
+    /** pie 에서 첫 시리즈만 사용됐는가. / Whether pie used only the first series. */
     pieReducedToFirst?: boolean;
+    /** pie 에서 음수를 절댓값 처리했는가. / Whether pie used absolute values for negatives. */
     negativesAbsInPie?: boolean;
-    /** SR 폴백 — extractor 가 렌더러와 무관하게 항상 채운다(§B 하드 게이트) */
+    /** SR 폴백 — extractor 가 렌더러와 무관하게 항상 채운다(§B 하드 게이트). / SR fallback — always filled by the extractor regardless of renderer (§B hard gate). */
     a11yTable: A11yTableModel;
 }
+/** 헤드리스 차트 데이터 모델(추출 산출물). / Headless chart data model (extraction output). */
 export interface ChartDataModel {
+    /** 카테고리(x축) 라벨. / Category (x-axis) labels. */
     categories: string[];
+    /** 시리즈 배열. / Series array. */
     series: ChartSeries[];
+    /** 모델 메타. / Model meta. */
     meta: ChartDataModelMeta;
 }
+/** 차트 테마(색·글꼴·팔레트). / Chart theme (colors, fonts, palette). */
 export interface ChartTheme {
+    /** 주 색. / Primary color. */
     primary: string;
+    /** 축·테두리 색. / Axis/border color. */
     border: string;
+    /** 텍스트 색. / Text color. */
     text: string;
+    /** 배경 색. / Background color. */
     bg: string;
+    /** 그리드 선 색. / Grid line color. */
     gridLine: string;
+    /** 글꼴 패밀리. / Font family. */
     fontFamily: string;
+    /** 기본 글꼴 크기(px). / Base font size in px. */
     fontSize: number;
+    /** 시리즈 순환 팔레트. / Series-cycling palette. */
     palette: string[];
 }
+/** 렌더 스펙(어댑터에 전달되는 스냅샷). / Render spec (snapshot passed to adapters). */
 export interface ChartRenderSpec {
+    /** 차트 타입. / Chart type. */
     type: ChartType;
+    /** 차트 제목. / Chart title. */
     title?: string;
+    /** 범례 표시/위치. / Legend visibility/position. */
     legend?: boolean | {
         position: 'top' | 'bottom' | 'left' | 'right';
     };
+    /** 툴팁 사용 여부. / Whether tooltips are enabled. */
     tooltip?: boolean;
+    /** 축 설정(라벨·min/max·스택). / Axis config (labels, min/max, stacked). */
     axis?: {
         xLabel?: string;
         yLabel?: string;
@@ -90,33 +128,56 @@ export interface ChartRenderSpec {
         yMax?: number;
         stacked?: boolean;
     };
+    /** 시리즈 팔레트(테마 팔레트 오버라이드). / Series palette (overrides theme palette). */
     palette?: string[];
+    /** 렌더 테마. / Render theme. */
     theme: ChartTheme;
+    /** 숫자 포맷터(축/툴팁/범례 컨텍스트). / Number formatter (axis/tooltip/legend context). */
     numberFormat?: (v: number, ctx: {
         axis: 'x' | 'y' | 'tooltip' | 'legend';
         field?: string;
     }) => string;
+    /** 접근성 테이블 모델. / Accessibility table model. */
     a11y: A11yTableModel;
 }
+/** 차트 포인트(히트테스트/클릭 대상). / Chart point (hit-test/click target). */
 export interface ChartPoint {
+    /** 시리즈 이름. / Series name. */
     seriesName: string;
+    /** 카테고리 라벨. / Category label. */
     category: string;
+    /** 값(결측 null). / Value (null if missing). */
     value: number | null;
+    /** 카테고리 인덱스. / Category index. */
     index: number;
+    /** 원본 행 stable id(있으면). / Source row stable id (if any). */
     rowId?: string;
 }
+/**
+ * 차트 렌더 어댑터(교체 seam) — 내장 canvas / 외부 lib 백엔드를 통일된 인터페이스로 감싼다.
+ * / Chart render adapter (swap seam) — wraps the built-in canvas / external-lib backends behind one interface.
+ */
 export interface ChartAdapter {
+    /** 어댑터 식별자. / Adapter identifier. */
     readonly id: string;
+    /** 호스트에 초기화. / Initialize into the host. */
     init(host: HTMLElement, spec: ChartRenderSpec): Promise<void>;
+    /** 모델을 렌더. / Render the model. */
     render(model: ChartDataModel, spec: ChartRenderSpec): void;
+    /** 렌더 영역 크기 변경. / Resize the render area. */
     resize(width: number, height: number): void;
+    /** 현재 렌더를 이미지 Blob 으로(선택). / Export current render as an image Blob (optional). */
     toBlob?(mime?: string): Promise<Blob | null>;
+    /** 포인트 클릭 콜백 등록(선택). / Register a point-click callback (optional). */
     onPointClick?(cb: (p: ChartPoint) => void): void;
+    /** 어댑터 정리. / Tear down the adapter. */
     destroy(): void;
 }
-/** createChart 반환 핸들(§6). 구현은 ChartManager. */
+/** createChart 반환 핸들(§6). 구현은 ChartManager. / Handle returned by createChart (§6); implemented by ChartManager. */
 export interface ChartInstance {
+    /** 차트 인스턴스 id. / Chart instance id. */
     readonly id: string;
+    /** 설정 패치 후 갱신. / Patch config and update. */
     update(patch?: Partial<ChartConfig>): void;
     /**
      * 모델을 재추출하고 렌더 스펙(테마 포함)을 재스냅샷해 재렌더한다(§5.3). 그리드는 테마 변경
@@ -124,56 +185,92 @@ export interface ChartInstance {
      * 변화 없는 순수 테마 전환 후에는, 열려 있는 각 차트에 대해 이 메서드를 호출해야 새 테마
      * (색·글꼴·팔레트)가 재적용된다. `update()`/`setType()`도 내부적으로 동일 경로를 탄다.
      */
+    /** 모델을 재추출하고 렌더 스펙(테마 포함)을 재스냅샷해 재렌더. / Re-extract the model and re-snapshot the render spec (incl. theme), then re-render. */
     refresh(): void;
+    /** 차트 타입 변경. / Change the chart type. */
     setType(type: ChartType): void;
+    /** 차트 인스턴스 파기. / Destroy the chart instance. */
     destroy(): void;
+    /** 현재 렌더를 이미지 Blob 으로. / Export current render as an image Blob. */
     toBlob(mime?: string): Promise<Blob | null>;
+    /** 현재 데이터 모델 반환. / Return the current data model. */
     getModel(): ChartDataModel;
+    /** 차트 이벤트 리스너 등록. / Register a chart event listener. */
     on(ev: 'chartRender' | 'chartPointClick', cb: (...a: any[]) => void): void;
 }
-/** GridOptions.chart 로 중첩되는 전역 옵션(C5.1, 최상위 flat 키 금지). */
+/** GridOptions.chart 로 중첩되는 전역 옵션(C5.1, 최상위 flat 키 금지). / Global options nested under GridOptions.chart (C5.1; no top-level flat keys). */
 export interface ChartGlobalOptions {
+    /** 차트 기능 활성화. / Enable the chart feature. */
     enabled?: boolean;
+    /** 기본 렌더 엔진. / Default render engine. */
     defaultEngine?: 'builtin' | 'chartjs' | 'echarts';
+    /** 기본 차트 타입. / Default chart type. */
     defaultType?: ChartType;
+    /** 기본 배치 방식. / Default placement. */
     placement?: 'docked' | 'modal' | 'inline' | 'floating';
+    /** 렌더 포인트 상한(초과 시 다운샘플). / Max render points (downsample above this). */
     maxPoints?: number;
+    /** live 갱신 디바운스(ms). / Debounce for live updates (ms). */
     debounceMs?: number;
+    /** 기본 팔레트. / Default palette. */
     palette?: string[];
+    /** 기본 숫자 포맷터. / Default number formatter. */
     numberFormat?: (v: number, ctx: {
         axis: 'x' | 'y' | 'tooltip' | 'legend';
         field?: string;
     }) => string;
+    /** 차트 생성 콜백. / Chart-create callback. */
     onChartCreate?: (i: ChartInstance) => void;
+    /** 차트 렌더 콜백. / Chart-render callback. */
     onChartRender?: (e: {
         id: string;
         model: ChartDataModel;
     }) => void;
+    /** 포인트 클릭 콜백. / Point-click callback. */
     onChartPointClick?: (e: {
         id: string;
         point: ChartPoint;
     }) => void;
+    /** 차트 파기 콜백. / Chart-destroy callback. */
     onChartDestroy?: (e: {
         id: string;
     }) => void;
 }
+/** createChart() 공개 설정(§6). / Public config for createChart() (§6). */
 export interface ChartConfig {
+    /** 데이터 소스. / Data source. */
     source: ChartSource;
+    /** 차트 타입. / Chart type. */
     type: ChartType;
+    /** 렌더 엔진 또는 커스텀 어댑터. / Render engine or custom adapter. */
     engine?: 'builtin' | 'chartjs' | 'echarts' | ChartAdapter;
+    /** 배치 방식. / Placement. */
     placement?: 'docked' | 'modal' | 'inline' | 'floating';
+    /** inline/floating 시 마운트 대상. / Mount target for inline/floating. */
     mount?: HTMLElement;
+    /** 카테고리(x축) 컬럼 field. / Category (x-axis) column field. */
     category?: string;
+    /** 시리즈 명세 목록. / Series specs. */
     series?: Array<string | ChartSeriesSpec>;
+    /** 카테고리 집계 연산. / Category aggregation op. */
     aggregate?: ChartAggregate;
+    /** 렌더 포인트 상한. / Max render points. */
     maxPoints?: number;
+    /** 데이터 변경 시 자동 갱신. / Auto-refresh on data changes. */
     live?: boolean;
+    /** 차트 제목. / Chart title. */
     title?: string;
+    /** 범례 설정. / Legend config. */
     legend?: ChartRenderSpec['legend'];
+    /** 툴팁 사용 여부. / Whether tooltips are enabled. */
     tooltip?: boolean;
+    /** 축 설정. / Axis config. */
     axis?: ChartRenderSpec['axis'];
+    /** 시리즈 팔레트. / Series palette. */
     palette?: string[];
+    /** 숫자 포맷터. / Number formatter. */
     numberFormat?: ChartRenderSpec['numberFormat'];
+    /** 렌더 크기(px). / Render size (px). */
     size?: {
         width: number;
         height: number;

package/dist/types/core/editors/CellEditor.d.ts

@@ -2,16 +2,25 @@ import { ColumnDef, EditorDef } from '../types.js';
 import { RenderContext } from '../renderers/CellRenderer.js';
 export { DateEditor } from './DateEditor.js';
 export { SelectEditor } from './SelectEditor.js';
+/** 편집 결과(커밋 여부 + 값). / Edit result (whether committed + value). */
 export interface EditorResult {
+    /** 커밋(확정) 여부. / Whether committed. */
     committed: boolean;
+    /** 편집된 값. / Edited value. */
     value: any;
 }
+/** 셀 에디터 인터페이스 — 편집 위젯 수명 관리. / Cell editor interface — manages the edit widget lifecycle. */
 export interface CellEditor {
+    /** 컨테이너에 편집 위젯을 마운트한다. / Mount the edit widget into the container. */
     mount(container: HTMLElement, ctx: RenderContext, onCommit: (value: any) => void, onCancel: () => void): void;
+    /** 현재 편집 값을 반환한다. / Return the current edit value. */
     getValue(): any;
+    /** 편집 위젯에 포커스한다. / Focus the edit widget. */
     focus(): void;
+    /** 편집 위젯을 정리한다. / Tear down the edit widget. */
     destroy(): void;
 }
+/** 텍스트 입력 에디터. / Text input editor. */
 export declare class TextEditor implements CellEditor {
     private input;
     private _onCommit;
@@ -23,6 +32,7 @@ export declare class TextEditor implements CellEditor {
     focus(): void;
     destroy(): void;
 }
+/** 숫자 입력 에디터(min/max/step 지원). / Number input editor (supports min/max/step). */
 export declare class NumberEditor implements CellEditor {
     private input;
     private _onCommit;
@@ -43,6 +53,7 @@ export declare class NumberEditor implements CellEditor {
     focus(): void;
     destroy(): void;
 }
+/** 체크박스 에디터(change 즉시 커밋). / Checkbox editor (commits immediately on change). */
 export declare class CheckboxEditor implements CellEditor {
     private chk;
     private _onCommit;
@@ -62,9 +73,25 @@ export declare class CheckboxEditor implements CellEditor {
  *  - number 는 def 가 있으면 min/max/step 을 옵션으로, 없으면 기본 NumberEditor.
  *  - select 는 def 가 있으면 def.options, 없으면 col.options 를 쓴다(원 switch 와 동일).
  */
+/** 셀 에디터 팩토리 시그니처 `(col, def?) => CellEditor`. / Cell-editor factory signature `(col, def?) => CellEditor`. */
 export type EditorFactory = (col: ColumnDef, def?: EditorDef) => CellEditor;
-/** 커스텀 셀 에디터 타입을 코어 편집 없이 등록(OCP). 프로세스 전역. */
+/**
+ * 커스텀 셀 에디터 타입을 코어 편집 없이 등록(OCP). 프로세스 전역.
+ * / Register a custom cell-editor type without editing core (OCP). Process-global.
+ *
+ * @param typeName - 에디터 타입 이름(예: 'color') / Editor type name (e.g. 'color')
+ * @param factory - 에디터 팩토리 / Editor factory
+ * @example
+ * registerEditor('color', () => new TextEditor());
+ */
 export declare function registerEditor(typeName: string, factory: EditorFactory): void;
-/** 등록 여부 조회(내부/테스트용). */
+/** 에디터 타입 등록 여부 조회(내부/테스트용). / Whether an editor type is registered (internal/test use). */
 export declare function hasEditor(typeName: string): boolean;
+/**
+ * 컬럼 정의로부터 셀 에디터를 생성한다(레지스트리 해석, 미등록 시 TextEditor 폴백).
+ * / Create a cell editor from a column definition (registry resolution; falls back to TextEditor when unregistered).
+ *
+ * @param col - 컬럼 정의 / Column definition
+ * @returns 셀 에디터 / A cell editor
+ */
 export declare function createEditor(col: ColumnDef): CellEditor;