open-grid 1.1.1 → 1.2.1

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

@@ -3,23 +3,55 @@ import { ColumnLayout } from './ColumnLayout.js';
 import { GridRenderer } from './GridRenderer.js';
 import { CellEditor } from './editors/CellEditor.js';
 import { ColumnDef } from './types.js';
+/**
+ * {@link CellEditManager} 의존성 주입 계약. / Dependency-injection contract for {@link CellEditManager}.
+ *
+ * 셀 편집기의 마운트/커밋에 필요한 데이터·렌더·i18n·수식 접근을 호스트 그리드가 제공한다.
+ * / The host grid supplies the data/render/i18n/formula access needed to mount and
+ * commit the cell editor.
+ */
 export interface CellEditDeps<T extends Record<string, any>> {
+    /** 데이터 레이어. / The data layer. */
     data: DataLayer<T>;
+    /** 컬럼 레이아웃. / The column layout. */
     colLayout: ColumnLayout<T>;
+    /** 현재 렌더러 조회(없으면 `null`). / Look up the current renderer (or `null`). */
     getRenderer: () => GridRenderer | null;
+    /** 그리드 컨테이너 엘리먼트 조회. / Look up the grid container element. */
     getContainer: () => HTMLElement;
+    /** 현재 그리드 옵션 조회. / Look up the current grid options. */
     getOptions: () => any;
+    /** 그리드 이벤트를 발행한다. / Emit a grid event. */
     emit: (event: string, ...args: any[]) => void;
+    /** 바디를 다시 그린다. / Re-render the body. */
     doRender: () => void;
+    /** 스크린리더용 상태 안내. / Announce a status message for screen readers. */
     announce: (msg: string) => void;
+    /** i18n: 편집 셀 위치 announce 해석 + 에디터 ctx 로케일 주입. / i18n: resolve edit-cell announce + inject locale into editor ctx. */
+    t: (key: string, params?: Record<string, string | number>) => string;
+    /** 셀 값을 기록한다(트리거/이벤트 발화 경로). / Write a cell value (goes through the trigger/event path). */
     writeCell: (ri: number, field: string, value: any) => void;
+    /** 지정 행이 보이도록 스크롤한다. / Scroll so the given row is visible. */
     scrollToRow: (ri: number) => void;
+    /** 현재 보이는(펼쳐진) 리프 컬럼 목록 조회. / Look up the currently visible leaf columns. */
     getVisibleLeaves: () => ColumnDef<T>[];
+    /** F3: 해당 셀이 수식을 갖는지 조회. / F3: check whether the cell currently holds a formula. */
     hasCellFormula?: (ri: number, field: string) => boolean;
+    /** F3: 셀의 수식 원문을 조회(없으면 `null`). / F3: get the cell's raw formula source (or `null`). */
     getCellFormula?: (ri: number, field: string) => string | null;
+    /** F3: 셀에 수식을 설정한다. / F3: set a formula on the cell. */
     setCellFormula?: (ri: number, field: string, formula: string) => void;
+    /** F3: 셀의 수식을 제거한다. / F3: clear the cell's formula. */
     clearCellFormula?: (ri: number, field: string) => void;
 }
+/**
+ * 셀 편집 생명주기(포커스·시작·커밋·취소)를 관리하는 매니저. / Manages the cell edit lifecycle (focus, start, commit, cancel).
+ *
+ * 활성 에디터 인스턴스와 편집/포커스 대상 셀 좌표를 소유하며, 키보드/마우스 두 진입
+ * 경로 모두에서 동일한 편집기 마운트·커밋 흐름을 재사용한다.
+ * / Owns the active editor instance and the edit/focus target cell coordinates, and
+ * reuses the same editor mount/commit flow for both the keyboard and mouse entry paths.
+ */
 export declare class CellEditManager<T extends Record<string, any> = any> {
     private _activeEditor;
     private _editCell;
@@ -27,23 +59,66 @@ export declare class CellEditManager<T extends Record<string, any> = any> {
     private _dragColIdx;
     private _d;
     constructor(deps: CellEditDeps<T>);
+    /** 현재 마운트된 에디터 인스턴스(없으면 `null`). / The currently mounted editor instance (or `null`). */
     get activeEditor(): CellEditor | null;
+    /** 현재 편집 중인 셀 좌표(없으면 `null`). / Coordinates of the cell currently being edited (or `null`). */
     get editCell(): {
         ri: number;
         ci: number;
     } | null;
+    /** 현재 키보드 포커스 셀 좌표(없으면 `null`). / Coordinates of the currently keyboard-focused cell (or `null`). */
     get focusCell(): {
         ri: number;
         ci: number;
     } | null;
+    /** 컬럼 드래그 중인 컬럼 인덱스(없으면 `null`). / Column index currently being column-dragged (or `null`). */
     get dragColIdx(): number | null;
     set dragColIdx(v: number | null);
+    /**
+     * 키보드 포커스 셀을 설정하고, 스크롤·재렌더·상태 announce 를 처리한다. / Set the keyboard-focused cell; handles scroll, re-render, and status announce.
+     *
+     * @param ri - 포커스할 행의 flat index / Flat index of the row to focus
+     * @param ci - 포커스할 컬럼 인덱스(보이는 리프 컬럼 기준) / Column index to focus, among visible leaf columns
+     */
     setFocusCell(ri: number, ci: number): void;
+    /** 키보드 포커스 셀을 해제한다. / Clear the keyboard-focused cell. */
     clearFocusCell(): void;
+    /**
+     * 키보드 진입(F2/Enter 등)으로 셀 편집을 시작한다. / Start cell editing via a keyboard entry point (F2/Enter, etc.).
+     *
+     * 토글형 컬럼(checkbox 등)은 에디터를 마운트하지 않고 값을 즉시 반전한다.
+     * / For toggle-type columns (checkbox, etc.), this flips the value immediately
+     * instead of mounting an editor.
+     *
+     * @param rowIndex - 편집할 행의 flat index / Flat index of the row to edit
+     * @param colIndex - 편집할 컬럼 인덱스(보이는 리프 컬럼 기준) / Column index to edit, among visible leaf columns
+     */
     startEditByKey(rowIndex: number, colIndex: number): void;
+    /**
+     * 마우스 진입(클릭/더블클릭)으로 셀 편집을 시작한다. / Start cell editing via a mouse entry point (click/double-click).
+     *
+     * `editable` 옵션·컬럼별 editable 함수·토글형 컬럼 여부를 모두 확인한 뒤
+     * 에디터를 마운트한다.
+     * / Checks the `editable` option, any per-column editable function, and whether
+     * the column is toggle-type before mounting the editor.
+     *
+     * @param rowIndex - 편집할 행의 flat index / Flat index of the row to edit
+     * @param colIndex - 편집할 컬럼 인덱스(보이는 리프 컬럼 기준) / Column index to edit, among visible leaf columns
+     * @param _e - 트리거한 마우스 이벤트(현재 미사용) / The triggering mouse event (currently unused)
+     */
     startEdit(rowIndex: number, colIndex: number, _e: MouseEvent): void;
+    /** 활성 에디터의 현재 값으로 편집을 커밋한다(활성 에디터가 없으면 무시). / Commit editing using the active editor's current value (no-op if none is active). */
     commitEdit(): void;
+    /**
+     * 지정 값으로 편집을 커밋한다(에디터의 onCommit 콜백 경로). / Commit editing with an explicit value (the editor's onCommit callback path).
+     *
+     * @param ri - 대상 행의 flat index / Flat index of the target row
+     * @param ci - 대상 컬럼 인덱스 / Target column index
+     * @param value - 커밋할 값 / Value to commit
+     */
     commitEditWithValue(ri: number, ci: number, value: any): void;
+    /** 편집을 취소한다(값 변경 없이 에디터만 해제). / Cancel editing (releases the editor without applying a value change). */
     cancelEdit(): void;
+    /** @internal */
     private _finishEdit;
 }

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

@@ -2,32 +2,129 @@ import { DataLayer } from './DataLayer.js';
 import { ColumnLayout } from './ColumnLayout.js';
 import { CellEditManager } from './CellEditManager.js';
 import { RowManager } from './RowManager.js';
+/**
+ * {@link CellEventHandler} 의존성 주입 계약. / Dependency-injection contract for {@link CellEventHandler}.
+ *
+ * DOM 셀 이벤트를 그리드 선택/편집/범위선택 서브시스템에 연결하는 데 필요한
+ * 접근 함수와 배선 훅을 호스트 그리드가 제공한다.
+ * / The host grid supplies the accessors and wiring hooks needed to route DOM
+ * cell events into the selection/edit/range-selection subsystems.
+ */
 export interface CellEventDeps<T extends Record<string, any>> {
+    /** 현재 데이터 레이어 조회. / Look up the current data layer. */
     getData: () => DataLayer<T>;
+    /** 현재 컬럼 레이아웃 조회. / Look up the current column layout. */
     getColLayout: () => ColumnLayout<T>;
+    /** 현재 그리드 옵션 조회. / Look up the current grid options. */
     getOptions: () => any;
+    /** 셀 편집 매니저 조회. / Look up the cell edit manager. */
     getEditMgr: () => CellEditManager<T>;
+    /** 행 선택/체크 매니저 조회. / Look up the row selection/check manager. */
     getRowMgr: () => RowManager<T>;
+    /** 그리드 이벤트를 발행한다. / Emit a grid event. */
     emit: (event: string, ...args: any[]) => void;
+    /** 셀 값을 기록한다(토글/라디오 컬럼 등에서 사용). / Write a cell value (used by toggle/radio columns, etc.). */
     writeCell: (ri: number, field: string, value: any) => void;
+    /** 바디를 다시 그린다. / Re-render the body. */
     doRender: () => void;
+    /** 그리드 컨테이너 엘리먼트 조회. / Look up the grid container element. */
     getContainer: () => HTMLElement;
-    /** 'cells' 모드 클릭/Shift+클릭 위임 — RangeSelectionManager.handleClick 로 연결 */
+    /** 'cells' 모드 클릭/Shift+클릭 위임 — RangeSelectionManager.handleClick 로 연결
+     * / Delegates 'cells'-mode click/Shift+click — wired to `RangeSelectionManager.handleClick`. */
     onCellsClick?: (ri: number, ci: number, shiftKey: boolean) => void;
-    /** 범위 드래그 선택 상태머신(§3.1) — RangeSelectionManager.handleCellMouseDown/Move/Up 로 연결 */
+    /** 범위 드래그 선택 상태머신(§3.1) — RangeSelectionManager.handleCellMouseDown/Move/Up 로 연결
+     * / Range drag-select state machine (§3.1) — wired to `RangeSelectionManager.handleCellMouseDown/Move/Up`. */
     rangeMouseDown?: (ri: number, ci: number, e: MouseEvent) => void;
+    /** {@link rangeMouseDown} 참조 — 드래그 이동 단계. / See {@link rangeMouseDown} — the drag-move phase. */
     rangeMouseMove?: (ri: number, ci: number, e: MouseEvent) => void;
+    /** {@link rangeMouseDown} 참조 — 드래그 종료 단계. / See {@link rangeMouseDown} — the drag-end phase. */
     rangeMouseUp?: (ri: number, ci: number, e: MouseEvent) => void;
 }
+/**
+ * 셀 DOM 이벤트(클릭·더블클릭·마우스·키)를 라우팅하는 핸들러. / Routes cell DOM events (click, double-click, mouse, key) to the right subsystem.
+ *
+ * 선택 모드(`single`/`multiple`/`row`/`cells`)에 따라 행/범위 선택을 위임하고,
+ * 토글·라디오 컬럼 값 반영, 편집 시작, 그리고 공개 셀/행 이벤트(`cellClick` 등)
+ * 발행까지 한 곳에서 처리한다.
+ * / Delegates row/range selection based on the selection mode (`single`/`multiple`/
+ * `row`/`cells`), applies toggle/radio column values, kicks off editing, and emits
+ * the public cell/row events (`cellClick`, etc.) — all in one place.
+ */
 export declare class CellEventHandler<T extends Record<string, any> = any> {
     private _d;
     constructor(deps: CellEventDeps<T>);
+    /**
+     * 셀 클릭을 처리한다: 선택 모드 적용, 토글/라디오 값 반영, `cellClick`/`rowClick`
+     * 이벤트 발행, 필요 시 편집 시작까지 수행한다.
+     * / Handles a cell click: applies the selection mode, updates toggle/radio values,
+     * emits `cellClick`/`rowClick`, and starts editing when appropriate.
+     *
+     * @param rowIndex - 클릭된 행의 flat index / Flat index of the clicked row
+     * @param colIndex - 클릭된 컬럼 인덱스(행 헤더 등은 -1일 수 있음) / Clicked column index (may be -1 for row-header-like clicks)
+     * @param e - 원본 마우스 이벤트 / The originating mouse event
+     */
     handleCellClick(rowIndex: number, colIndex: number, e: MouseEvent): void;
+    /**
+     * 셀 더블클릭을 처리한다: `cellDblClick`/`rowDblClick` 발행, `editMode:'dblclick'` 이면 편집 시작.
+     * / Handles a cell double-click: emits `cellDblClick`/`rowDblClick`, and starts editing
+     * when `editMode` is `'dblclick'`.
+     *
+     * @param rowIndex - 대상 행의 flat index / Flat index of the target row
+     * @param colIndex - 대상 컬럼 인덱스 / Target column index
+     * @param e - 원본 마우스 이벤트 / The originating mouse event
+     */
     handleCellDblClick(rowIndex: number, colIndex: number, e: MouseEvent): void;
+    /**
+     * 마우스 오버: `cellMouseOver`/`rowMouseOver` 이벤트를 발행한다. / Mouse-over: emits `cellMouseOver`/`rowMouseOver`.
+     *
+     * @param ri - 대상 행의 flat index / Flat index of the target row
+     * @param ci - 대상 컬럼 인덱스 / Target column index
+     * @param e - 원본 마우스 이벤트 / The originating mouse event
+     */
     handleCellMouseOver(ri: number, ci: number, e: MouseEvent): void;
+    /**
+     * 마우스 아웃: `cellMouseOut`/`rowMouseOut` 이벤트를 발행한다. / Mouse-out: emits `cellMouseOut`/`rowMouseOut`.
+     *
+     * @param ri - 대상 행의 flat index / Flat index of the target row
+     * @param ci - 대상 컬럼 인덱스 / Target column index
+     * @param e - 원본 마우스 이벤트 / The originating mouse event
+     */
     handleCellMouseOut(ri: number, ci: number, e: MouseEvent): void;
+    /**
+     * 마우스 다운: 범위 드래그 선택 상태머신을 먼저 위임한 뒤 `cellMouseDown`/`rowMouseDown` 을 발행한다.
+     * / Mouse-down: delegates to the range drag-select state machine first, then emits
+     * `cellMouseDown`/`rowMouseDown`.
+     *
+     * @param ri - 대상 행의 flat index / Flat index of the target row
+     * @param ci - 대상 컬럼 인덱스 / Target column index
+     * @param e - 원본 마우스 이벤트 / The originating mouse event
+     */
     handleCellMouseDown(ri: number, ci: number, e: MouseEvent): void;
+    /**
+     * 마우스 업: 범위 드래그 선택 종료를 위임한 뒤 `cellMouseUp`/`rowMouseUp` 을 발행한다.
+     * / Mouse-up: delegates the drag-select end, then emits `cellMouseUp`/`rowMouseUp`.
+     *
+     * @param ri - 대상 행의 flat index / Flat index of the target row
+     * @param ci - 대상 컬럼 인덱스 / Target column index
+     * @param e - 원본 마우스 이벤트 / The originating mouse event
+     */
     handleCellMouseUp(ri: number, ci: number, e: MouseEvent): void;
+    /**
+     * 마우스 이동: 범위 드래그 확장을 위임한 뒤 `cellMouseMove`/`rowMouseMove` 를 발행한다.
+     * / Mouse-move: delegates the drag-select extension, then emits `cellMouseMove`/`rowMouseMove`.
+     *
+     * @param ri - 대상 행의 flat index / Flat index of the target row
+     * @param ci - 대상 컬럼 인덱스 / Target column index
+     * @param e - 원본 마우스 이벤트 / The originating mouse event
+     */
     handleCellMouseMove(ri: number, ci: number, e: MouseEvent): void;
+    /**
+     * 현재 포커스 셀에 대한 키보드 이벤트를 공개 이벤트로 발행한다(편집 중이거나 포커스 셀이 없으면 무시).
+     * / Emits a public event for a keyboard action on the currently focused cell
+     * (no-op while editing or when there is no focus cell).
+     *
+     * @param eventName - 발행할 이벤트 종류 / Which event kind to emit
+     * @param e - 원본 키보드 이벤트 / The originating keyboard event
+     */
     handleCellKeyEvt(eventName: 'cellKeyDown' | 'cellKeyUp' | 'cellKeyPress', e: KeyboardEvent): void;
 }

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

@@ -2,29 +2,76 @@ import { CellRange } from './types.js';
 import { FlatRowModel } from './FlatRowModel.js';
 import { ChartConfig, ChartInstance } from './chart/types.js';
 import { ChartColumnRef } from './chart/DataExtractor.js';
+/**
+ * ChartManager 가 그리드 서브시스템을 읽기 위해 주입받는 클로저 묶음. / Closures injected into
+ * ChartManager so it can read grid subsystem state without owning it directly.
+ */
 export interface ChartManagerDeps {
+    /** 차트 패널을 붙일 그리드 컨테이너 엘리먼트. / Grid container element the chart panel mounts into. */
     getContainer(): HTMLElement;
+    /** 현재 GridOptions(차트 관련 `options.chart` 포함). / Current GridOptions (includes `options.chart`). */
     getOptions(): any;
+    /** 필터/정렬 적용 전 전체 행. / All rows, before filter/sort. */
     getAllRows(): Array<Record<string, any>>;
+    /** 현재 선택된 행. / Currently selected rows. */
     getSelectedRows(): Array<Record<string, any>>;
+    /** 현재 체크된 행. / Currently checked rows. */
     getCheckedRows(): Array<Record<string, any>>;
-    /** ColumnLayout.visibleLeaves 투영(숨김 제외, C0.4). */
+    /** ColumnLayout.visibleLeaves 투영(숨김 제외, C0.4). / Projection of ColumnLayout.visibleLeaves (hidden columns excluded, C0.4). */
     getVisibleColumns(): ChartColumnRef[];
+    /** 행 합성 결과를 조회하는 baseline 모델. / Baseline model exposing the composed row structure. */
     getFlatModel(): FlatRowModel;
+    /** stable rowId 로 원본 행을 조회(없으면 undefined). / Look up the source row by stable rowId (undefined if absent). */
     getRowById(rowId: string): Record<string, any> | undefined;
-    /** F1 seam(C4). 없으면 range 소스는 selection 으로 강등(§7). */
+    /** F1 seam(C4). 없으면 range 소스는 selection 으로 강등(§7). / F1 seam (C4); when absent, a `range` source degrades to `selection` (§7). */
     getActiveRange?(): CellRange | null;
-    /** 그리드 이벤트 구독/해제(EventEmitter). */
+    /** 그리드 이벤트 구독/해제(EventEmitter). / Subscribe/unsubscribe grid events (EventEmitter). */
     on(ev: string, cb: (...a: any[]) => void): void;
     off(ev: string, cb: (...a: any[]) => void): void;
+    /** 그리드 이벤트 발행. / Emit a grid event. */
     emit(ev: string, ...args: any[]): void;
+    /** aria-live 영역에 메시지를 공지. / Announce a message via the aria-live region. */
     announce(msg: string): void;
+    /** i18n: 차트 배지·패널 aria·announce 해석. / i18n: resolve chart badges/panel-aria/announce. */
+    t(key: string, params?: Record<string, string | number>): string;
 }
+/** F4 차트 인스턴스 핸들(update/refresh/destroy 등). 정의는 chart/types.js 참고.
+ * / F4 chart instance handle (update/refresh/destroy, etc.). See chart/types.js for the definition. */
 export type { ChartInstance } from './chart/types.js';
+/**
+ * F4 통합 차트 매니저. / F4 integrated chart manager.
+ *
+ * 차트 설정(`ChartConfig`)을 받아 데이터 추출 → 다운샘플 → 렌더 스펙 조립 → 어댑터 렌더까지의
+ * 파이프라인을 실행하고, 생성된 각 차트를 라이브 갱신(dataChange/formulaRecalc)·리사이즈·파괴까지
+ * 책임지고 관리한다. / Given a `ChartConfig`, runs the pipeline from data extraction through
+ * downsampling, render-spec assembly, and adapter rendering, then owns each created chart's
+ * live updates (dataChange/formulaRecalc), resize handling, and teardown.
+ */
 export declare class ChartManager {
     private _d;
     private _charts;
     constructor(deps: ChartManagerDeps);
+    /**
+     * 새 차트를 생성해 그리드에 마운트한다. / Create a new chart and mount it into the grid.
+     *
+     * 범위 스냅샷(source.kind==='range') → 어댑터 결정 → 패널 DOM 구성 → 데이터 추출/렌더 →
+     * 배지/라이브구독/리사이즈 관찰까지 한 번에 처리한다. 초기화 도중 실패하면 부분 생성된
+     * DOM/구독을 정리하고 원 예외를 다시 던진다.
+     * / Handles range snapshotting (when source.kind==='range'), adapter resolution, panel DOM
+     * construction, data extraction/render, badges, live subscription, and resize observation in
+     * one call. If initialization fails partway, partially created DOM/subscriptions are cleaned up
+     * and the original error is re-thrown.
+     *
+     * @param config - 차트 생성 설정(소스·타입·배치 등) / Chart creation config (source, type, placement, etc.)
+     * @returns 생성된 차트 인스턴스 핸들 / Handle for the created chart instance
+     * @example
+     * const chart = chartManager.createChart({
+     *   source: { kind: 'selection' },
+     *   type: 'bar',
+     *   category: 'name',
+     * });
+     * chart.on('chartRender', () => console.log('rendered'));
+     */
     createChart(config: ChartConfig): ChartInstance;
     /**
      * config.size 가 명시되면 그대로 쓴다. 없으면 host 의 실측 clientWidth(실브라우저에서
@@ -34,7 +81,10 @@ export declare class ChartManager {
      */
     private _resolveRenderSize;
     private _attachResizeObserver;
+    /** 파괴되지 않은 모든 차트 인스턴스를 반환한다. / Return all chart instances that have not been destroyed. */
     getCharts(): ChartInstance[];
+    /** 이 매니저가 소유한 모든 차트를 파괴한다(DOM 제거·구독 해제 포함).
+     * / Destroy every chart owned by this manager (DOM removal and unsubscription included). */
     destroyCharts(): void;
     private _snapshotRange;
     private _extract;

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

@@ -1,17 +1,45 @@
 import { ContextMenuItem } from './types.js';
 export type { ContextMenuItem };
+/**
+ * 기본 컨텍스트 메뉴 항목이 위임하는 액션 핸들러 모음. / Action handlers that the default context-menu items delegate to.
+ *
+ * `OpenGrid` 가 생성 시 주입하며, 커스텀 메뉴 항목이 `action: 'sortAsc'` 등
+ * 문자열 액션을 쓸 때 실제 동작을 제공한다. / Injected by `OpenGrid` at construction time;
+ * provides the real behavior when a custom menu item uses a string `action` like `'sortAsc'`.
+ */
 export interface ContextMenuActions {
+    /** 오름차순 정렬 실행. / Runs ascending sort. */
     onSortAsc: () => void;
+    /** 내림차순 정렬 실행. / Runs descending sort. */
     onSortDesc: () => void;
+    /** 찾기 바 열기. / Opens the find bar. */
     onFind: () => void;
+    /** Excel 내보내기 실행. / Runs the Excel export. */
     onExcel: () => void;
+    /** CSV 내보내기 실행. / Runs the CSV export. */
     onCsv: () => void;
+    /** 인쇄 실행. / Runs print. */
     onPrint: () => void;
 }
+/** i18n: 메시지 해석기 시그니처. / i18n: message resolver signature. */
+export type ContextMenuT = (key: string, params?: Record<string, string | number>) => string;
+/** 기본 메뉴 항목(ko 라벨) — i18n 미주입 폴백 + 구조 계약(테스트/공개 표면). / Default items (ko labels) — i18n fallback + structural contract. */
 export declare const DEFAULT_CONTEXT_ITEMS: ContextMenuItem[];
+/**
+ * 우클릭 팝업 컨텍스트 메뉴 관리자. / Manages the right-click popup context menu.
+ *
+ * 메뉴는 `document.body` 자식으로 추가한다(그리드 컨테이너의 조상에 transform/filter
+ * 가 있어도 `position:fixed` 기준점이 뷰포트에 고정되도록). 테마(`data-og-theme`)와
+ * 스킨(`data-og-skin`) 속성은 앵커 엘리먼트에서 복사해 CSS 변수 상속을 보존한다.
+ * / The menu is appended as a child of `document.body` (so its `position:fixed`
+ * reference stays the viewport even when an ancestor of the grid container has a
+ * transform/filter). The theme (`data-og-theme`) and skin (`data-og-skin`) attributes
+ * are copied from the anchor element to preserve CSS-variable inheritance.
+ */
 export declare class ContextMenuManager {
     private readonly _anchor;
     private readonly _actions;
+    private readonly _t?;
     private _el;
     private _docClick;
     private _docKey;
@@ -19,14 +47,31 @@ export declare class ContextMenuManager {
     private _docMouseMove;
     private _focusIdx;
     /**
-     * @param _anchor  그리드 컨테이너 엘리먼트 — CSS 변수 상속 기준점
-     * @param _actions 기본 액션 핸들러 (OpenGrid에서 주입)
+     * @param _anchor - 그리드 컨테이너 엘리먼트 — CSS 변수 상속 기준점 / Grid container element — the reference point for CSS-variable inheritance
+     * @param _actions - 기본 액션 핸들러(OpenGrid에서 주입) / Default action handlers (injected by OpenGrid)
+     * @param _t - i18n 메시지 해석기(미주입 시 ko 기본 라벨) / i18n message resolver (falls back to ko default labels when absent)
+     */
+    constructor(_anchor: HTMLElement, _actions: ContextMenuActions, _t?: ContextMenuT | undefined);
+    /**
+     * 지정 좌표에 컨텍스트 메뉴를 연다. / Open the context menu at the given coordinates.
+     *
+     * 이전 메뉴가 열려 있으면 먼저 닫는다. 항목을 지정하지 않으면 활성 로케일로
+     * 만든 기본 항목({@link DEFAULT_CONTEXT_ITEMS})을 사용한다.
+     * / Closes any previously open menu first. When no items are given, uses the
+     * default items ({@link DEFAULT_CONTEXT_ITEMS}) built in the active locale.
+     *
+     * @param e - 메뉴를 연 마우스 이벤트(좌표 기준) / Mouse event that opened the menu (used for positioning)
+     * @param customItems - 커스텀 메뉴 항목(생략 시 기본 항목) / Custom menu items (defaults when omitted)
      */
-    constructor(_anchor: HTMLElement, _actions: ContextMenuActions);
     open(e: MouseEvent, customItems?: ContextMenuItem[]): void;
+    /** 열려 있는 메뉴를 닫고 관련 리스너를 모두 해제한다. / Close the open menu and detach all related listeners. */
     close(): void;
+    /** 메뉴를 닫고 정리한다. / Close the menu and clean up. */
     destroy(): void;
+    /** @internal 뷰포트 경계를 벗어나지 않도록 메뉴 위치를 계산해 배치한다. / Computes and applies the menu position, keeping it within viewport bounds. */
     private _position;
+    /** @internal 활성 항목 사이에서 키보드 포커스를 이동한다. / Moves keyboard focus between enabled items. */
     private _moveFocus;
+    /** @internal 항목의 함수 액션 또는 문자열 액션(→ ContextMenuActions)을 실행한다. / Runs an item's function action, or its string action (dispatched to ContextMenuActions). */
     private _runAction;
 }

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

@@ -14,57 +14,128 @@ import { GridOptions, OpenGridInstance, Position, GridDropEvent } from './types.
  * `getPeerController(target)` 로 얻은 상대 컨트롤러의 동명 메서드로 수행한다 — `this`(source) 와
  * peer(target) 로 갈라 원본의 `this._x` / `targetGrid._x` 접근을 1:1 재현한다(회귀 0).
  * **3단계 drop emit 순서(before→후 이동→after→complete, 각 source→target)는 정확히 보존한다.**
+ * / Dependency contract that moves the cross-grid move/mapping/drop surface (`moveRowsTo`/
+ * `moveCheckedTo`/cross-transform resolution/the 3-phase drop event firing) out of the
+ * `OpenGrid` God object with **behavior unchanged** (R7, §3.1 C8, §6-R7). `OpenGrid` retains
+ * only thin delegating public methods (public API unchanged — the R0 `public_api_surface.txt`
+ * is frozen).
+ *
+ * Strangler principle (A2): `crossGridRegistry` (a process-scoped singleton in
+ * `CrossGridRegistry.ts`) is kept **AS-IS** for now — promoting it to an injected
+ * `GridRegistry` (C8, R-6c) is deferred to the R8 composition root.
+ *
+ * A cross-grid move involves **two grids** (source = `this`, target) at once. Since each
+ * `OpenGrid` owns its own `CrossGridController`, target-side operations (insert/rowCount/
+ * columns/3-phase firing) are carried out via the same-named methods on the peer controller
+ * obtained through `getPeerController(target)` — splitting into `this` (source) and `peer`
+ * (target) reproduces the original's `this._x` / `targetGrid._x` access 1:1 (zero regression).
+ * **The 3-phase drop emit order (before → move → after → complete, each source → target) is
+ * preserved exactly.**
  */
 export interface CrossGridControllerDeps<T extends Record<string, any> = any> {
-    /** GridDropEvent 의 sourceGrid/targetGrid 식별자 + 자기동일성 비교에 쓰는 소유 그리드. */
+    /** GridDropEvent 의 sourceGrid/targetGrid 식별자 + 자기동일성 비교에 쓰는 소유 그리드.
+     * / The owning grid, used both as the GridDropEvent's sourceGrid/targetGrid identifier and
+     * for self-identity comparison. */
     getSelf: () => OpenGridInstance<T>;
     getData: () => DataLayer<T>;
     getColLayout: () => ColumnLayout<T>;
     getOptions: () => Required<GridOptions<T>>;
-    /** EventEmitter fan(this.emit) — 'gridDropBefore/After/Complete'/'gridDropMapping'. */
+    /** EventEmitter fan(this.emit) — 'gridDropBefore/After/Complete'/'gridDropMapping'.
+     * / EventEmitter fan-out (this.emit) for 'gridDropBefore/After/Complete'/'gridDropMapping'. */
     emit: (event: string, payload?: any) => void;
-    /** 공개 insertRow 위임(MutationService 경유) — target 삽입에 쓰인다. */
+    /** 공개 insertRow 위임(MutationService 경유) — target 삽입에 쓰인다.
+     * / Delegates to the public insertRow (via MutationService) — used for target-side insertion. */
     insertRow: (item: Partial<T>, position?: Position) => void;
-    /** 공개 deleteRow 위임(MutationService 경유) — source 제거에 쓰인다. */
+    /** 공개 deleteRow 위임(MutationService 경유) — source 제거에 쓰인다.
+     * / Delegates to the public deleteRow (via MutationService) — used for source-side removal. */
     deleteRow: (rowIndex: number | number[]) => void;
-    /** rowMgr.getChecked() — moveCheckedTo. */
+    /** rowMgr.getChecked() — moveCheckedTo. / rowMgr.getChecked() — used by moveCheckedTo. */
     getChecked: () => Array<{
         rowIndex: number;
     }>;
-    /** rowMgr.uncheckAll()(+재렌더) 공개 위임 — moveCheckedTo. */
+    /** rowMgr.uncheckAll()(+재렌더) 공개 위임 — moveCheckedTo.
+     * / Delegates to the public rowMgr.uncheckAll() (+ re-render) — used by moveCheckedTo. */
     uncheckAll: () => void;
-    /** 드래그 선택 집합 해석(_dragRowSet). OpenGrid 가 소유(RowDragDrop 배선과 공유). */
+    /** 드래그 선택 집합 해석(_dragRowSet). OpenGrid 가 소유(RowDragDrop 배선과 공유).
+     * / Resolves the drag selection set (_dragRowSet). Owned by OpenGrid (shared with the
+     * RowDragDrop wiring). */
     dragRowSet: (fromIndex: number) => number[];
-    /** 상대 그리드의 CrossGridController 획득(피어 연산 위임). 비 OpenGrid 대상은 undefined. */
+    /** 상대 그리드의 CrossGridController 획득(피어 연산 위임). 비 OpenGrid 대상은 undefined.
+     * / Obtains the peer grid's CrossGridController for delegated peer operations. `undefined`
+     * for non-OpenGrid targets. */
     getPeerController: (grid: OpenGridInstance<T>) => CrossGridController<T> | undefined;
 }
+/**
+ * 그리드↔그리드 이동·매핑·드롭 조정자. / Grid-to-grid move/mapping/drop coordinator.
+ *
+ * 드래그 또는 화살표 셔틀로 촉발되는 행 이동, 스키마가 다른 그리드 간 필드 매핑, 3단계
+ * drop 이벤트(before→after→complete) 발화를 담당한다(R7).
+ * / Handles row moves triggered by drag or the arrow-key shuttle, field mapping between
+ * grids with different schemas, and firing the 3-phase drop event (before→after→complete) (R7).
+ */
 export declare class CrossGridController<T extends Record<string, any> = any> {
     private _deps;
     constructor(deps: CrossGridControllerDeps<T>);
-    /** 이 그리드의 소유 인스턴스(GridDropEvent 식별자). */
+    /** 이 그리드의 소유 인스턴스(GridDropEvent 식별자). / This grid's owning instance (the GridDropEvent identifier). */
     getSelf(): OpenGridInstance<T>;
     private _rowCount;
     private _insertRow;
     private _visibleLeafInfos;
-    /** 드래그 드롭 어댑터 → 공개 moveRowsTo 로 위임 */
+    /**
+     * 드래그 드롭 어댑터 → 공개 moveRowsTo 로 위임. / Drag-drop adapter that delegates to the
+     * public moveRowsTo.
+     *
+     * @param fromIndex - 드래그 원본 행 인덱스 / Source row index of the drag
+     * @param targetBodyEl - 드롭 대상 그리드의 바디 엘리먼트(crossGridRegistry 조회 키) / Target grid's body element (lookup key into crossGridRegistry)
+     * @param targetIndex - 대상 그리드에서 삽입할 인덱스 / Insert index in the target grid
+     */
     handleCrossGridDrop(fromIndex: number, targetBodyEl: HTMLElement, targetIndex: number): void;
     /**
      * 이 그리드의 행들을 다른 그리드로 이동(move)한다. 드래그·화살표 셔틀 공통 경로.
      * 3단계 이벤트(before→after→complete)와 crossGridMapping(필드 매핑)을 적용한다.
-     * @param target  대상 그리드
-     * @param sourceIndexes 이동할 (표시)행 인덱스들
-     * @param targetIndex 대상에서 삽입 위치 (생략 시 맨 끝에 추가)
-     * @returns 이동 성공 true, 취소/무효 false
+     * / Move this grid's rows into another grid. The shared path for drag and the arrow-key
+     * shuttle. Applies the 3-phase event (before→after→complete) and crossGridMapping
+     * (field mapping).
+     *
+     * @param target - 대상 그리드 / The target grid
+     * @param sourceIndexes - 이동할 (표시)행 인덱스들 / (Displayed) row indexes to move
+     * @param targetIndex - 대상에서 삽입 위치 (생략 시 맨 끝에 추가) / Insert position in the target (omit to append at the end)
+     * @returns 이동 성공 true, 취소/무효 false / `true` if the move succeeded, `false` if cancelled/invalid
      */
     moveRowsTo(target: OpenGridInstance<T>, sourceIndexes: number[], targetIndex?: number): Promise<boolean>;
-    /** 체크된 행을 다른 그리드로 이동 (화살표 셔틀용). 체크 없으면 무시. */
+    /**
+     * 체크된 행을 다른 그리드로 이동 (화살표 셔틀용). 체크 없으면 무시.
+     * / Move checked rows into another grid (for the arrow-key shuttle). No-op if none are checked.
+     *
+     * @param target - 대상 그리드 / The target grid
+     * @returns 이동 성공 true, 취소/무효(체크 없음 포함) false / `true` if the move succeeded, `false` if cancelled/invalid (including no checked rows)
+     */
     moveCheckedTo(target: OpenGridInstance<T>): Promise<boolean>;
     /**
      * 크로스그리드 이동의 행 변환 함수를 결정한다.
      * 반환: null=변환 불필요(그대로) / 함수=변환 적용 / false=매핑 모달 취소(이동 중단)
      */
     private _resolveCrossTransform;
+    /**
+     * 이동 전 이벤트를 발화한다. 핸들러가 `false` 를 반환하거나 `e.cancel` 을 세우면 이동이 중단된다.
+     * / Fire the pre-move event. If a handler returns `false` or sets `e.cancel`, the move is aborted.
+     *
+     * @param e - drop 이벤트 페이로드 / The drop event payload
+     * @returns 핸들러의 반환값(취소 판단에 쓰임) / The handler's return value (used to decide cancellation)
+     */
     fireGridDropBefore(e: GridDropEvent<T>): boolean | void;
+    /**
+     * 이동 후(삽입/삭제 반영 후) 이벤트를 발화한다. / Fire the post-move event (after insert/delete
+     * have taken effect).
+     *
+     * @param e - drop 이벤트 페이로드 / The drop event payload
+     */
     fireGridDropAfter(e: GridDropEvent<T>): void;
+    /**
+     * 이동 완료(양쪽 재렌더까지 반영) 이벤트를 발화한다. / Fire the completion event (after both
+     * grids have re-rendered).
+     *
+     * @param e - drop 이벤트 페이로드 / The drop event payload
+     */
     fireGridDropComplete(e: GridDropEvent<T>): void;
 }

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

@@ -1,12 +1,46 @@
 import { OpenGrid } from './OpenGrid.js';
+/**
+ * 크로스그리드 레지스트리. / Cross-grid registry.
+ *
+ * 그리드 바디(`.og-body-wrapper`) 엘리먼트를 그리드 인스턴스에 매핑한다.
+ * 그리드↔그리드 드래그(좌표 → 타깃 그리드)와 화살표 셔틀이 공유하는 전역 조회처다.
+ * / Maps each grid body (`.og-body-wrapper`) element to its grid instance. Shared by
+ * grid-to-grid drag (coordinate → target grid) and the arrow-key shuttle as the
+ * global lookup point.
+ */
 export declare class CrossGridRegistry {
     private _map;
+    /**
+     * 바디 엘리먼트 → 그리드 매핑을 등록한다. / Register a body element → grid mapping.
+     *
+     * @param bodyEl - 그리드 바디 래퍼 엘리먼트 / The grid body wrapper element
+     * @param grid - 대응 그리드 인스턴스 / The corresponding grid instance
+     */
     register(bodyEl: HTMLElement, grid: OpenGrid<any>): void;
+    /**
+     * 등록을 해제한다. / Remove a registration.
+     *
+     * @param bodyEl - 해제할 바디 엘리먼트 / The body element to unregister
+     */
     unregister(bodyEl: HTMLElement): void;
+    /**
+     * 바디 엘리먼트로 그리드를 조회한다. / Look up a grid by its body element.
+     *
+     * @param bodyEl - 그리드 바디 래퍼 엘리먼트 / The grid body wrapper element
+     * @returns 매핑된 그리드, 없으면 `undefined` / The mapped grid, or `undefined`
+     */
     get(bodyEl: HTMLElement): OpenGrid<any> | undefined;
+    /** 등록된 그리드 수. / Number of registered grids. */
     get size(): number;
-    /** 커서 좌표 아래의 다른(crossGrid 허용) 그리드 반환. 없으면 null */
+    /**
+     * 커서 좌표 아래의 다른(crossGrid 허용) 그리드를 반환한다. / Resolve another (crossGrid-enabled) grid under the cursor.
+     *
+     * @param clientX - 커서 X 좌표(뷰포트 기준) / Cursor X in viewport coordinates
+     * @param clientY - 커서 Y 좌표(뷰포트 기준) / Cursor Y in viewport coordinates
+     * @param exclude - 제외할 그리드(보통 드래그 원본) / Grid to exclude (usually the drag source)
+     * @returns 좌표 아래의 대상 그리드, 없으면 `null` / The target grid under the point, or `null`
+     */
     resolveAt(clientX: number, clientY: number, exclude: OpenGrid<any>): OpenGrid<any> | null;
 }
-/** 전역 단일 레지스트리 */
+/** 전역 단일 레지스트리. / Global singleton registry. */
 export declare const crossGridRegistry: CrossGridRegistry;