open-grid 1.3.1 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -15,33 +15,100 @@ import { CFRule } from './cf/CFRule.js';
15
15
  import { IRealtimeSource, RealtimeController, RtAnnounceSummary, FrameScheduler } from './realtime/index.js';
16
16
  /**
17
17
  * `setRealtimeSource` 에 넘기는 실시간 배선 옵션. 전부 선택 항목이며, 생략하면 안전한 기본값이 쓰인다.
18
- * / Options passed to `setRealtimeSource` for wiring a realtime source; all optional, with safe defaults.
18
+ *
19
+ * Options passed to `setRealtimeSource` for wiring a realtime source; all optional, with safe defaults.
20
+ *
21
+ * `setRealtimeSource` に渡すリアルタイム配線オプション。すべて任意項目で、省略すると安全な既定値が使われます。
22
+ *
23
+ * 传给 `setRealtimeSource` 的实时配线选项。全部为可选项,省略时采用安全的默认值。
19
24
  */
20
25
  export interface RealtimeWireOptions {
21
- /** 프레임당 최대 적용 셀 수(백프레셔). / Max cells applied per frame (backpressure). */
26
+ /**
27
+ * 프레임당 최대 적용 셀 수(백프레셔).
28
+ *
29
+ * Max cells applied per frame (backpressure).
30
+ *
31
+ * フレームあたりの最大適用セル数(バックプレッシャー)。
32
+ *
33
+ * 每帧最多应用的单元格数(背压)。
34
+ */
22
35
  maxBatchPerFrame?: number;
23
- /** 프레임 스케줄러 주입(헤드리스/테스트 결정론). 기본=rAF/폴백. / Injected frame scheduler; default rAF/fallback. */
36
+ /**
37
+ * 프레임 스케줄러 주입(헤드리스/테스트 결정론). 기본=rAF/폴백.
38
+ *
39
+ * Injected frame scheduler; default rAF/fallback.
40
+ *
41
+ * フレームスケジューラの注入(ヘッドレス/テストの決定性)。既定=rAF/フォールバック。
42
+ *
43
+ * 注入帧调度器(无头/测试的确定性)。默认=rAF/回退。
44
+ */
24
45
  scheduleFrame?: FrameScheduler;
25
- /** stale 판정 임계(ms). 기본 5000. / Stale threshold(ms); default 5000. */
46
+ /**
47
+ * stale 판정 임계(ms). 기본 5000.
48
+ *
49
+ * Stale threshold(ms); default 5000.
50
+ *
51
+ * stale 判定のしきい値(ms)。既定 5000。
52
+ *
53
+ * stale 判定的阈值(ms)。默认 5000。
54
+ */
26
55
  staleAfterMs?: number;
27
- /** 실시간 갱신 규모를 스크린리더에 알릴 요약 콜백(aria-live 연동). 미지정 시 아무 것도 알리지 않는다. / Callback that hands a summary of realtime updates to a screen reader (aria-live). Announces nothing when omitted. */
56
+ /**
57
+ * 실시간 갱신 규모를 스크린리더에 알릴 요약 콜백(aria-live 연동). 미지정 시 아무 것도 알리지 않는다.
58
+ *
59
+ * Callback that hands a summary of realtime updates to a screen reader (aria-live). Announces nothing when omitted.
60
+ *
61
+ * リアルタイム更新の規模をスクリーンリーダーに伝える要約コールバック(aria-live 連携)。未指定の場合は何も通知しません。
62
+ *
63
+ * 向屏幕阅读器通知实时更新规模的摘要回调(aria-live 联动)。未指定时不通知任何内容。
64
+ */
28
65
  announce?: (summary: RtAnnounceSummary) => void;
29
- /** SR 디바운스 윈도우(ms). 기본 500. / SR debounce window(ms); default 500. */
66
+ /**
67
+ * SR 디바운스 윈도우(ms). 기본 500.
68
+ *
69
+ * SR debounce window(ms); default 500.
70
+ *
71
+ * SR のデバウンスウィンドウ(ms)。既定 500。
72
+ *
73
+ * SR 防抖窗口(ms)。默认 500。
74
+ */
30
75
  debounceMs?: number;
31
76
  }
32
77
  /**
33
- * OPEN_GRID 코어 그리드 클래스. / The OPEN_GRID core grid class.
78
+ * OPEN_GRID 코어 그리드 클래스.
79
+ *
80
+ * The OPEN_GRID core grid class.
81
+ *
82
+ * OPEN_GRID のコアグリッドクラス。
83
+ *
84
+ * OPEN_GRID 的核心表格类。
34
85
  *
35
86
  * 컨테이너 요소에 마운트되어 가상 스크롤로 대량 행을 렌더하는 초경량 데이터 그리드. 수천~수십만 행을
36
87
  * 표로 다루면서 정렬·필터·그룹/트리·병합·범위 선택과 채우기·마스터/디테일·셀 수식·그리드 데이터 통합
37
88
  * 차트가 필요할 때 쓴다. 코어를 고치지 않고 동작을 바꾸는 override/strategy 확장 커널을 함께 제공한다.
38
- * / An ultra-light data grid that mounts into a container element and renders large row sets through
89
+ *
90
+ * An ultra-light data grid that mounts into a container element and renders large row sets through
39
91
  * virtual scrolling. Use it to present thousands to hundreds of thousands of rows with sorting,
40
92
  * filtering, group/tree, merging, range selection & fill, master/detail, cell formulas, and integrated
41
93
  * charts backed by the grid data. It also ships the override/strategy extension kernel for changing
42
94
  * behavior without editing the core.
43
95
  *
44
- * @typeParam T - 행 데이터 타입 / Row data type
96
+ * コンテナ要素にマウントされ、仮想スクロールで大量の行をレンダリングする超軽量データグリッドです。数千~数十万行を
97
+ * 表として扱いながら、ソート・フィルター・グループ/ツリー・結合・範囲選択と塗りつぶし・マスター/ディテール・セル数式・
98
+ * グリッドデータ統合チャートが必要なときに使います。コアを修正せずに動作を変える override/strategy 拡張カーネルも
99
+ * 併せて提供します。
100
+ *
101
+ * 挂载到容器元素、以虚拟滚动渲染大量行的超轻量数据表格。需要把数千至数十万行当作表格处理,同时使用排序、
102
+ * 筛选、分组/树、合并、范围选择与填充、主从明细、单元格公式、基于表格数据的集成图表时使用。还一并提供
103
+ * 无需修改核心即可改变行为的 override/strategy 扩展内核。
104
+ *
105
+ * @typeParam T - 행 데이터 타입
106
+ *
107
+ * Row data type
108
+ *
109
+ * 行データの型
110
+ *
111
+ * 行数据的类型
45
112
  * @example
46
113
  * const grid = new OpenGrid('#host', {
47
114
  * columns: [
@@ -61,25 +128,81 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
61
128
  private _ro;
62
129
  private _renderer;
63
130
  private _appearance;
64
- /** R12c: per-instance 아이콘 오버라이드 레지스트리(전역 iconRegistry 의 child). 첫 setIcon 때 지연 생성. */
131
+ /**
132
+ * R12c: per-instance 아이콘 오버라이드 레지스트리(전역 iconRegistry 의 child). 첫 setIcon 때 지연 생성.
133
+ *
134
+ * R12c: per-instance icon override registry (a child of the global iconRegistry); lazily created on the first setIcon.
135
+ *
136
+ * R12c: インスタンスごとのアイコンオーバーライドレジストリ(グローバル iconRegistry の child)。最初の setIcon 時に遅延生成。
137
+ *
138
+ * R12c: 按实例的图标覆盖注册表(全局 iconRegistry 的 child)。首次 setIcon 时延迟创建。
139
+ */
65
140
  private _icons;
66
- /** i18n: per-instance 로케일 오버라이드 레지스트리(전역 localeRegistry 의 child). locale/messages 옵션 또는 첫 setLocale/setMessage 때 지연 생성. */
141
+ /**
142
+ * i18n: per-instance 로케일 오버라이드 레지스트리(전역 localeRegistry 의 child). locale/messages 옵션 또는 첫 setLocale/setMessage 때 지연 생성.
143
+ *
144
+ * i18n: per-instance locale override registry (a child of the global localeRegistry); lazily created from the locale/messages options or on the first setLocale/setMessage.
145
+ *
146
+ * i18n: インスタンスごとのロケールオーバーライドレジストリ(グローバル localeRegistry の child)。locale/messages オプション、または最初の setLocale/setMessage 時に遅延生成。
147
+ *
148
+ * i18n: 按实例的区域设置覆盖注册表(全局 localeRegistry 的 child)。由 locale/messages 选项,或首次 setLocale/setMessage 时延迟创建。
149
+ */
67
150
  private _locales;
68
151
  private _sfMgr;
69
152
  private _rowMgr;
70
153
  private _editMgr;
71
154
  private _trigMgr;
72
155
  private _destroyed;
73
- /** R5(§3.1 C4): 렌더 루프 컨트롤러. `_mount` 에서 renderer/vs 배선 초입에 생성. */
156
+ /**
157
+ * R5(§3.1 C4): 렌더 루프 컨트롤러. `_mount` 에서 renderer/vs 배선 초입에 생성.
158
+ *
159
+ * R5 (§3.1 C4): the render-loop controller; created in `_mount` at the start of the renderer/vs wiring.
160
+ *
161
+ * R5(§3.1 C4): レンダーループのコントローラ。`_mount` で renderer/vs 配線の冒頭に生成。
162
+ *
163
+ * R5(§3.1 C4): 渲染循环的控制器。在 `_mount` 中于 renderer/vs 配线的开头生成。
164
+ */
74
165
  private _render;
75
- /** R6(§3.1 C5): 데이터 변경 서비스(setData/insert/push/delete/writeCell/writeCells + batch + commit). */
166
+ /**
167
+ * R6(§3.1 C5): 데이터 변경 서비스(setData/insert/push/delete/writeCell/writeCells + batch + commit).
168
+ *
169
+ * R6 (§3.1 C5): the data mutation service (setData/insert/push/delete/writeCell/writeCells + batch + commit).
170
+ *
171
+ * R6(§3.1 C5): データ変更サービス(setData/insert/push/delete/writeCell/writeCells + batch + commit)。
172
+ *
173
+ * R6(§3.1 C5): 数据变更服务(setData/insert/push/delete/writeCell/writeCells + batch + commit)。
174
+ */
76
175
  private _mutation;
77
- /** R7(§3.1 C9): F3 수식 컨트롤러(accessor 조립·recalc flush·에러 표현 + 공개 수식 API). */
176
+ /**
177
+ * R7(§3.1 C9): F3 수식 컨트롤러(accessor 조립·recalc flush·에러 표현 + 공개 수식 API).
178
+ *
179
+ * R7 (§3.1 C9): the F3 formula controller (accessor assembly, recalc flush, error surfacing + the public formula API).
180
+ *
181
+ * R7(§3.1 C9): F3 数式コントローラ(accessor の組み立て・recalc の flush・エラー表現 + 公開数式 API)。
182
+ *
183
+ * R7(§3.1 C9): F3 公式控制器(accessor 的组装、recalc 的 flush、错误呈现 + 公开公式 API)。
184
+ */
78
185
  private _formula;
79
- /** R7(§3.1 C8): 크로스그리드 컨트롤러(moveRowsTo/매핑/3단계 드롭 발화). */
186
+ /**
187
+ * R7(§3.1 C8): 크로스그리드 컨트롤러(moveRowsTo/매핑/3단계 드롭 발화).
188
+ *
189
+ * R7 (§3.1 C8): the cross-grid controller (moveRowsTo / mapping / three-phase drop emission).
190
+ *
191
+ * R7(§3.1 C8): クロスグリッドのコントローラ(moveRowsTo/マッピング/3 段階ドロップの発火)。
192
+ *
193
+ * R7(§3.1 C8): 跨表格控制器(moveRowsTo/映射/3 阶段拖放的触发)。
194
+ */
80
195
  private _cross;
81
196
  private _colWidths;
82
- /** 사용자가 헤더 드래그로 직접 조절한 컬럼 폭 (field 기준). _recalcWidths 가 덮어쓰지 않도록 보존 */
197
+ /**
198
+ * 사용자가 헤더 드래그로 직접 조절한 컬럼 폭 (field 기준). _recalcWidths 가 덮어쓰지 않도록 보존
199
+ *
200
+ * Column widths the user adjusted by dragging the header (keyed by field); preserved so that _recalcWidths does not overwrite them.
201
+ *
202
+ * ユーザーがヘッダーのドラッグで直接調整した列幅(field 基準)。_recalcWidths が上書きしないよう保存します。
203
+ *
204
+ * 用户通过拖动表头直接调整的列宽(以 field 为准)。为防止 _recalcWidths 覆盖而保留。
205
+ */
83
206
  private _userWidths;
84
207
  private _filterPanel;
85
208
  private _filterSelect;
@@ -97,29 +220,125 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
97
220
  private _findMgr;
98
221
  private _grpMgr;
99
222
  private _cellEvt;
100
- /** F1: 범위 선택 + 채우기 핸들 배선 관리자(11_design_F1_v2.md). */
223
+ /**
224
+ * F1: 범위 선택 + 채우기 핸들 배선 관리자(11_design_F1_v2.md).
225
+ *
226
+ * F1: the manager wiring range selection + the fill handle (11_design_F1_v2.md).
227
+ *
228
+ * F1: 範囲選択 + 塗りつぶしハンドルの配線マネージャ(11_design_F1_v2.md)。
229
+ *
230
+ * F1: 范围选择 + 填充手柄的配线管理器(11_design_F1_v2.md)。
231
+ */
101
232
  private _rangeMgr;
102
- /** F2: 마스터/디테일 배선(11_design_F2_v2.md). 헤드리스 코어(core/detail/*)를 소비. */
233
+ /**
234
+ * F2: 마스터/디테일 배선(11_design_F2_v2.md). 헤드리스 코어(core/detail/*)를 소비.
235
+ *
236
+ * F2: master/detail wiring (11_design_F2_v2.md); consumes the headless core (core/detail/*).
237
+ *
238
+ * F2: マスター/ディテールの配線(11_design_F2_v2.md)。ヘッドレスコア(core/detail/*)を利用。
239
+ *
240
+ * F2: 主从明细的配线(11_design_F2_v2.md)。使用无头核心(core/detail/*)。
241
+ */
103
242
  private _detailMgr;
104
- /** F4: 그리드 데이터 통합 차트 오케스트레이터(11_design_F4_v2.md). 헤드리스 chart/* 소비. */
243
+ /**
244
+ * F4: 그리드 데이터 통합 차트 오케스트레이터(11_design_F4_v2.md). 헤드리스 chart/* 소비.
245
+ *
246
+ * F4: the grid-data integrated chart orchestrator (11_design_F4_v2.md); consumes the headless chart/*.
247
+ *
248
+ * F4: グリッドデータ統合チャートのオーケストレータ(11_design_F4_v2.md)。ヘッドレスな chart/* を利用。
249
+ *
250
+ * F4: 表格数据集成图表的编排器(11_design_F4_v2.md)。使用无头的 chart/*。
251
+ */
105
252
  private _chartMgr;
106
- /** Phase 0(C0.3): flat/visual index ↔ data 리졸버. 어떤 기능도 켜지지 않아도 항상 존재. */
253
+ /**
254
+ * Phase 0(C0.3): flat/visual index ↔ data 리졸버. 어떤 기능도 켜지지 않아도 항상 존재.
255
+ *
256
+ * Phase 0 (C0.3): the flat/visual index ↔ data resolver; always present even when no feature is enabled.
257
+ *
258
+ * Phase 0(C0.3): flat/visual index ↔ data のリゾルバ。どの機能も有効でなくても常に存在します。
259
+ *
260
+ * Phase 0(C0.3): flat/visual index ↔ data 的解析器。即使未启用任何功能也始终存在。
261
+ */
107
262
  private _flatModel;
108
- /** F3: 셀 수식 헤드리스 오케스트레이터(core/formula/* 소비, 재구현 아님). 항상 존재(헤드리스라 유휴 비용 0). */
263
+ /**
264
+ * F3: 셀 수식 헤드리스 오케스트레이터(core/formula/* 소비, 재구현 아님). 항상 존재(헤드리스라 유휴 비용 0).
265
+ *
266
+ * F3: the headless cell-formula orchestrator (consumes core/formula/*, not a re-implementation); always present (headless, so zero idle cost).
267
+ *
268
+ * F3: セル数式のヘッドレスオーケストレータ(core/formula/* を利用し、再実装ではありません)。常に存在します(ヘッドレスなのでアイドルコストは 0)。
269
+ *
270
+ * F3: 单元格公式的无头编排器(使用 core/formula/*,并非重新实现)。始终存在(无头,空闲成本为 0)。
271
+ */
109
272
  private _recalc;
110
- /** F3(C2): writeCell 단건 쓰기가 쌓아두는 dirty seed. endBatch/즉시 flush 시 onValuesChanged 1회로 소비. */
273
+ /**
274
+ * F3(C2): writeCell 단건 쓰기가 쌓아두는 dirty seed. endBatch/즉시 flush 시 onValuesChanged 1회로 소비.
275
+ *
276
+ * F3 (C2): dirty seeds accumulated by single writeCell writes; consumed by one onValuesChanged at endBatch/immediate flush.
277
+ *
278
+ * F3(C2): writeCell の単件書き込みが積み上げる dirty seed。endBatch/即時 flush の際に onValuesChanged 1 回で消費します。
279
+ *
280
+ * F3(C2): writeCell 的单件写入所积累的 dirty seed。endBatch/即时 flush 时以 1 次 onValuesChanged 消费。
281
+ */
111
282
  private _formulaDirtySeeds;
112
- /** CF 엔진(동적 import 로 조립). 미설정=null → applyCF 콜백 즉시 return(byte-identical). / CF engine (lazily assembled). */
283
+ /**
284
+ * CF 엔진(동적 import 로 조립). 미설정=null → applyCF 콜백 즉시 return(byte-identical).
285
+ *
286
+ * CF engine (lazily assembled).
287
+ *
288
+ * CF エンジン(動的 import で組み立て)。未設定=null → applyCF コールバックは即座に return(byte-identical)。
289
+ *
290
+ * CF 引擎(以动态 import 组装)。未设置=null → applyCF 回调立即 return(byte-identical)。
291
+ */
113
292
  private _cf;
114
- /** 컬럼별 통계 캐시(per-render 재계산 금지 — setConditionalFormat/데이터변경 시에만 갱신). / Per-column stats cache. */
293
+ /**
294
+ * 컬럼별 통계 캐시(per-render 재계산 금지 — setConditionalFormat/데이터변경 시에만 갱신).
295
+ *
296
+ * Per-column stats cache.
297
+ *
298
+ * 列ごとの統計キャッシュ(レンダーごとの再計算は禁止 — setConditionalFormat/データ変更時のみ更新)。
299
+ *
300
+ * 按列的统计缓存(禁止每次渲染重算 — 仅在 setConditionalFormat/数据变更时更新)。
301
+ */
115
302
  private _cfStats;
116
- /** 현재 적용된 CF 규칙(데이터 변경 시 통계 재계산에 재사용). / Currently applied CF rules. */
303
+ /**
304
+ * 현재 적용된 CF 규칙(데이터 변경 시 통계 재계산에 재사용).
305
+ *
306
+ * Currently applied CF rules.
307
+ *
308
+ * 現在適用されている CF ルール(データ変更時の統計再計算に再利用)。
309
+ *
310
+ * 当前已应用的 CF 规则(数据变更时的统计重算中复用)。
311
+ */
117
312
  private _cfRules;
118
- /** CF 색 시드 읽기 포트(동적 import 후 보관 — cf/ 정적 참조 회피로 별 청크 유지). / CF appearance read port. */
313
+ /**
314
+ * CF 색 시드 읽기 포트(동적 import 후 보관 — cf/ 정적 참조 회피로 별 청크 유지).
315
+ *
316
+ * CF appearance read port.
317
+ *
318
+ * CF の色シード読み取りポート(動的 import 後に保持 — cf/ の静的参照を避けて別チャンクを維持)。
319
+ *
320
+ * CF 的颜色种子读取端口(动态 import 后保留 — 避开对 cf/ 的静态引用以维持独立分块)。
321
+ */
119
322
  private _cfAppearance;
120
- /** CF 통계 계산기(cf/ 동적 청크에서 보관 — 동기 재계산용, cf/ 정적 참조 회피). / CF stats computer captured from the dynamic chunk. */
323
+ /**
324
+ * CF 통계 계산기(cf/ 동적 청크에서 보관 — 동기 재계산용, cf/ 정적 참조 회피).
325
+ *
326
+ * CF stats computer captured from the dynamic chunk.
327
+ *
328
+ * CF の統計計算機(cf/ の動的チャンクから保持 — 同期再計算用、cf/ の静的参照を回避)。
329
+ *
330
+ * CF 的统计计算器(从 cf/ 的动态分块中保留 — 用于同步重算,避开对 cf/ 的静态引用)。
331
+ */
121
332
  private _cfComputeStats;
122
- /** RT 컨트롤러(동적 import 로 조립). 미설정=null → 실시간 미배선(byte-identical). / Realtime controller (lazily assembled). */
333
+ /**
334
+ * RT 컨트롤러(동적 import 로 조립). 미설정=null → 실시간 미배선(byte-identical).
335
+ *
336
+ * Realtime controller (lazily assembled).
337
+ *
338
+ * RT コントローラ(動的 import で組み立て)。未設定=null → リアルタイムは未配線(byte-identical)。
339
+ *
340
+ * RT 控制器(以动态 import 组装)。未设置=null → 实时未配线(byte-identical)。
341
+ */
123
342
  private _rt;
124
343
  private _ovk;
125
344
  /**
@@ -127,60 +346,183 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
127
346
  * 레이어를 얹고(`grid.override(name, (orig, ...args) => ...)`), `.strategy(slot, fn)` 으로는 코어가
128
347
  * 미리 열어 둔 확장 슬롯(예: 표시 텍스트 포맷터)에 함수를 꽂는다. 특정 그리드의 표시·계산·검증 로직만
129
348
  * 살짝 바꾸고 싶을 때 상속·포크 없이 쓰는 훅. destroy 시 모든 레이어가 자동 복구된다.
130
- * / Entry point to wrap and change this instance's public-method behavior without editing the core.
349
+ *
350
+ * Entry point to wrap and change this instance's public-method behavior without editing the core.
131
351
  * Calling it layers a wrapper over the original (`grid.override(name, (orig, ...args) => ...)`);
132
352
  * `.strategy(slot, fn)` plugs a function into a slot the core opened in advance (e.g. the display
133
353
  * formatter). Use it as a hook when you want to tweak one grid's display/compute/validation logic
134
354
  * without subclassing or forking. All layers are restored automatically on destroy.
355
+ *
356
+ * このインスタンスの公開メソッドの動作を、コアを修正せずにラップして変える入口です。呼び出すと元のメソッドを包む
357
+ * レイヤーを重ね(`grid.override(name, (orig, ...args) => ...)`)、`.strategy(slot, fn)` ではコアがあらかじめ
358
+ * 開いておいた拡張スロット(例: 表示テキストのフォーマッタ)に関数を差し込みます。特定のグリッドの表示・計算・検証
359
+ * ロジックだけを少し変えたいときに、継承やフォークなしで使うフックです。destroy 時にすべてのレイヤーが自動的に
360
+ * 復元されます。
361
+ *
362
+ * 把这个实例的公开方法行为包起来、无需修改核心即可改变的入口。调用后会在原方法之上叠加一层包装
363
+ * (`grid.override(name, (orig, ...args) => ...)`),`.strategy(slot, fn)` 则把函数插入核心事先开放的
364
+ * 扩展槽(例如显示文本的格式化器)。想只稍微改动某个表格的显示、计算、校验逻辑时,可以不用继承或 fork 而使用的
365
+ * 钩子。destroy 时所有层都会自动恢复。
366
+ *
135
367
  * @example
136
368
  * grid.override('getDisplayValue', (orig, ri, field) => orig(ri, field).toUpperCase());
137
369
  * grid.override.strategy('displayFormatter', (v) => v == null ? '-' : String(v));
138
370
  */
139
371
  override: OverrideApi<T>;
140
- /** R11(§3.1 C7): 커널 위 타입드 확장점 레지스트리. _mount 초입에 생성(커널 준비 후). */
372
+ /**
373
+ * R11(§3.1 C7): 커널 위 타입드 확장점 레지스트리. _mount 초입에 생성(커널 준비 후).
374
+ *
375
+ * R11 (§3.1 C7): the typed extension-point registry on top of the kernel; created at the start of _mount (after the kernel is ready).
376
+ *
377
+ * R11(§3.1 C7): カーネル上の型付き拡張点レジストリ。_mount の冒頭で生成(カーネル準備後)。
378
+ *
379
+ * R11(§3.1 C7): 内核之上的类型化扩展点注册表。在 _mount 的开头生成(内核准备完成后)。
380
+ */
141
381
  private _extensions;
142
382
  /**
143
383
  * 확장점 레지스트리 정면 — 렌더훅 등록, strategy/override 타입드 카탈로그, 커밋 전후 훅(MutationHook)을
144
384
  * 한곳에서 발견·등록한다. 코어를 고치지 않고 셀 클래스·aria 라벨·표시 텍스트 같은 렌더 파이프라인 지점에
145
385
  * 끼어들고 싶을 때 진입점으로 쓴다. 반환값으로 훅을 등록하면 다음 렌더부터 반영된다.
146
- * / Facade for the extension-point registry — discover and register render hooks, the typed
386
+ *
387
+ * Facade for the extension-point registry — discover and register render hooks, the typed
147
388
  * strategy/override catalog, and before/after commit hooks (MutationHook) in one place. Use it as
148
389
  * the entry point when you want to hook into the render pipeline (cell class, aria label, display
149
390
  * text) without editing the core; hooks you register apply from the next render on.
150
391
  *
151
- * @returns 확장점 레지스트리 / The extension-point registry
392
+ * 拡張点レジストリのファサード — レンダーフックの登録、strategy/override の型付きカタログ、コミット前後のフック
393
+ * (MutationHook)を一箇所で発見・登録します。コアを修正せずに、セルクラス・aria ラベル・表示テキストといった
394
+ * レンダーパイプラインの地点に割り込みたいときの入口として使います。戻り値でフックを登録すると、次のレンダーから
395
+ * 反映されます。
396
+ *
397
+ * 扩展点注册表的门面 — 在一处发现并注册渲染钩子、strategy/override 的类型化目录、提交前后的钩子
398
+ * (MutationHook)。想在不修改核心的前提下,介入单元格类名、aria 标签、显示文本这类渲染管线的地点时,
399
+ * 用它作为入口。用返回值注册钩子后,从下一次渲染开始生效。
400
+ *
401
+ * @returns 확장점 레지스트리
402
+ *
403
+ * The extension-point registry
404
+ *
405
+ * 拡張点レジストリ
406
+ *
407
+ * 扩展点注册表
152
408
  */
153
409
  get extensions(): ExtensionPointRegistry<T>;
154
- /** 정적 전역 override 레이어 (모든 신규 인스턴스에 생성자 말미 적용). */
410
+ /**
411
+ * 정적 전역 override 레이어 (모든 신규 인스턴스에 생성자 말미 적용).
412
+ *
413
+ * Static global override layers (applied at the end of the constructor to every new instance).
414
+ *
415
+ * 静的グローバルな override レイヤー(すべての新規インスタンスにコンストラクタ末尾で適用)。
416
+ *
417
+ * 静态全局的 override 层(在构造函数末尾应用到所有新实例)。
418
+ */
155
419
  private static _defaultOverrides;
156
- /** 정적 전역 strategy 슬롯. */
420
+ /**
421
+ * 정적 전역 strategy 슬롯.
422
+ *
423
+ * Static global strategy slots.
424
+ *
425
+ * 静的グローバルな strategy スロット。
426
+ *
427
+ * 静态全局的 strategy 槽。
428
+ */
157
429
  private static _defaultStrategies;
158
430
  /**
159
- * 정적: 모든 신규 그리드에 적용될 override 레이어 등록. / Static: register an override layer
160
- * applied to every newly created grid.
431
+ * 정적: 모든 신규 그리드에 적용될 override 레이어 등록.
432
+ *
433
+ * Static: register an override layer applied to every newly created grid.
434
+ *
435
+ * 静的: すべての新規グリッドに適用される override レイヤーを登録。
436
+ *
437
+ * 静态: 注册应用到所有新建表格的 override 层。
438
+ *
439
+ * @param name - 대상 공개 메서드 이름
440
+ *
441
+ * Target public method name
442
+ *
443
+ * 対象となる公開メソッド名
444
+ *
445
+ * 目标公开方法名
446
+ *
447
+ * @param fn - override 레이어 함수(첫 인자 orig)
448
+ *
449
+ * Override layer function (first arg = orig)
450
+ *
451
+ * override レイヤー関数(第 1 引数が orig)
452
+ *
453
+ * override 层函数(第 1 个参数为 orig)
454
+ *
455
+ * @param opts - 재진입/에러 정책
456
+ *
457
+ * Reentrancy & error policy
458
+ *
459
+ * 再入/エラーのポリシー
460
+ *
461
+ * 重入/错误的策略
462
+ *
463
+ * @returns 체이닝용 OpenGrid 클래스
464
+ *
465
+ * The OpenGrid class for chaining
466
+ *
467
+ * チェーン用の OpenGrid クラス
468
+ *
469
+ * 用于链式调用的 OpenGrid 类
161
470
  *
162
- * @param name - 대상 공개 메서드 이름 / Target public method name
163
- * @param fn - override 레이어 함수(첫 인자 orig) / Override layer function (first arg = orig)
164
- * @param opts - 재진입/에러 정책 / Reentrancy & error policy
165
- * @returns 체이닝용 OpenGrid 클래스 / The OpenGrid class for chaining
166
471
  * @example
167
472
  * OpenGrid.defaultOverride('getDisplayValue', (orig, ri, field) => orig(ri, field).toUpperCase());
168
473
  */
169
474
  static defaultOverride(name: string, fn: OverrideLayer, opts?: OverrideCallOptions): typeof OpenGrid;
170
- /** 정적 전역 defaults 네임스페이스 (strategy 슬롯). / Static global defaults namespace (strategy slots). */
475
+ /**
476
+ * 정적 전역 defaults 네임스페이스 (strategy 슬롯).
477
+ *
478
+ * Static global defaults namespace (strategy slots).
479
+ *
480
+ * 静的グローバルな defaults 名前空間(strategy スロット)。
481
+ *
482
+ * 静态全局的 defaults 命名空间(strategy 槽)。
483
+ */
171
484
  static defaults: {
172
485
  strategy(slot: string, fn: Function): typeof OpenGrid;
173
486
  };
174
487
  /**
175
488
  * 커스텀 셀 렌더러 타입을 코어 편집 없이 등록. `col.type`/`col.renderer`(문자열 또는 `{type}`)가
176
489
  * `typeName` 과 일치하면 등록 팩토리가 렌더러를 생성한다. 프로세스 전역(모든 그리드 인스턴스 공유).
177
- * / Register a custom cell renderer type without editing the core. When `col.type`/`col.renderer`
490
+ *
491
+ * Register a custom cell renderer type without editing the core. When `col.type`/`col.renderer`
178
492
  * (string or `{type}`) matches `typeName`, the registered factory creates the renderer.
179
493
  * Process-global (shared by all grid instances).
180
494
  *
181
- * @param typeName - 렌더러 타입 이름 / Renderer type name
182
- * @param factory - 렌더러 팩토리 / Renderer factory
183
- * @returns 체이닝용 OpenGrid 클래스 / The OpenGrid class for chaining
495
+ * カスタムセルレンダラーの型を、コアを修正せずに登録します。`col.type`/`col.renderer`(文字列または `{type}`)が
496
+ * `typeName` と一致すると、登録したファクトリがレンダラーを生成します。プロセスグローバル(すべてのグリッド
497
+ * インスタンスで共有)。
498
+ *
499
+ * 注册自定义单元格渲染器的类型,无需修改核心。`col.type`/`col.renderer`(字符串或 `{type}`)与
500
+ * `typeName` 一致时,注册的工厂会生成渲染器。进程全局(所有表格实例共享)。
501
+ *
502
+ * @param typeName - 렌더러 타입 이름
503
+ *
504
+ * Renderer type name
505
+ *
506
+ * レンダラーの型名
507
+ *
508
+ * 渲染器的类型名
509
+ *
510
+ * @param factory - 렌더러 팩토리
511
+ *
512
+ * Renderer factory
513
+ *
514
+ * レンダラーのファクトリ
515
+ *
516
+ * 渲染器的工厂
517
+ *
518
+ * @returns 체이닝용 OpenGrid 클래스
519
+ *
520
+ * The OpenGrid class for chaining
521
+ *
522
+ * チェーン用の OpenGrid クラス
523
+ *
524
+ * 用于链式调用的 OpenGrid 类
525
+ *
184
526
  * @example
185
527
  * OpenGrid.registerRenderer('stars', () => ({ render: (ctx) => '★'.repeat(ctx.value) }));
186
528
  */
@@ -189,13 +531,43 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
189
531
  * 커스텀 셀 에디터 타입을 코어 편집 없이 등록한다. 셀을 편집 상태로 열 때 `col.editor` 가 `typeName`
190
532
  * 과 일치하면 등록한 팩토리가 에디터를 만든다. 기본 제공 에디터(text/number/date 등)로 부족한 입력 UI가
191
533
  * 필요할 때 쓴다. 프로세스 전역이라 한 번 등록하면 모든 그리드 인스턴스가 공유한다.
192
- * / Register a custom cell editor type without editing the core. When a cell opens for editing and
534
+ *
535
+ * Register a custom cell editor type without editing the core. When a cell opens for editing and
193
536
  * `col.editor` matches `typeName`, the registered factory creates the editor. Use it when the
194
537
  * built-in editors (text/number/date, …) are not enough. Process-global (shared by all instances).
195
538
  *
196
- * @param typeName - 에디터 타입 이름 / Editor type name
197
- * @param factory - 에디터 팩토리 / Editor factory
198
- * @returns 체이닝용 OpenGrid 클래스 / The OpenGrid class for chaining
539
+ * カスタムセルエディタの型を、コアを修正せずに登録します。セルを編集状態で開くとき `col.editor` が `typeName`
540
+ * と一致すると、登録したファクトリがエディタを生成します。標準提供のエディタ(text/number/date など)では足りない
541
+ * 入力 UI が必要なときに使います。プロセスグローバルなので、一度登録すればすべてのグリッドインスタンスで共有されます。
542
+ *
543
+ * 注册自定义单元格编辑器的类型,无需修改核心。打开单元格进入编辑状态时,若 `col.editor` 与 `typeName`
544
+ * 一致,注册的工厂会创建编辑器。内置编辑器(text/number/date 等)不够用时使用。进程全局,注册一次后所有
545
+ * 表格实例共享。
546
+ *
547
+ * @param typeName - 에디터 타입 이름
548
+ *
549
+ * Editor type name
550
+ *
551
+ * エディタの型名
552
+ *
553
+ * 编辑器的类型名
554
+ *
555
+ * @param factory - 에디터 팩토리
556
+ *
557
+ * Editor factory
558
+ *
559
+ * エディタのファクトリ
560
+ *
561
+ * 编辑器的工厂
562
+ *
563
+ * @returns 체이닝용 OpenGrid 클래스
564
+ *
565
+ * The OpenGrid class for chaining
566
+ *
567
+ * チェーン用の OpenGrid クラス
568
+ *
569
+ * 用于链式调用的 OpenGrid 类
570
+ *
199
571
  * @example
200
572
  * OpenGrid.registerEditor('slider', () => {
201
573
  * let input: HTMLInputElement;
@@ -219,18 +591,51 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
219
591
  * 그리드의 "생김새"만 바꾸고 싶을 때 쓴다 — 한 번 등록하면 어떤 인스턴스든 `grid.setSkin(name)` 으로
220
592
  * 골라 쓴다. 내부 동작: 델타를 FORM 전용으로 검증(색 리터럴이 섞이면 색⊥형태 직교성을 깨므로 **throw**)하고
221
593
  * 포커스 링 접근성 가드레일을 적용한 뒤, 런타임 `<style>` 로 `.og-container[data-og-skin="name"]` 블록을 주입한다.
222
- * / Register a custom skin (the FORM axis — shape/border/radius) globally without editing the core.
594
+ *
595
+ * Register a custom skin (the FORM axis — shape/border/radius) globally without editing the core.
223
596
  * Use it when you want to restyle only the grid's "look" independently of the color theme; once
224
597
  * registered, any instance can pick it via `grid.setSkin(name)`. It validates the delta as
225
598
  * FORM-only (**throws** if a color literal is present, to keep color⊥form orthogonal), applies the
226
599
  * focus-ring accessibility guardrail, then injects a runtime `<style>` block for
227
600
  * `.og-container[data-og-skin="name"]`.
228
601
  *
229
- * @param name - 스킨 id / Skin id
230
- * @param delta - FORM 전용 토큰 델타(색값 넣으면 throw) / FORM-only token delta (throws on color values)
231
- * @returns 체이닝용 OpenGrid 클래스 / The OpenGrid class for chaining
602
+ * カスタムスキン(形状・輪郭線・角丸といった FORM 軸)を、コアを修正せずにグローバル登録します。カラーテーマとは
603
+ * 別に、グリッドの「見た目」だけを変えたいときに使います — 一度登録すれば、どのインスタンスでも
604
+ * `grid.setSkin(name)` で選んで使えます。内部動作: デルタを FORM 専用として検証し(色リテラルが混ざると
605
+ * 色⊥形状の直交性が崩れるため **throw**)、フォーカスリングのアクセシビリティガードレールを適用したうえで、
606
+ * ランタイムの `<style>` で `.og-container[data-og-skin="name"]` ブロックを注入します。
607
+ *
608
+ * 把自定义皮肤(形状、轮廓线、圆角这类 FORM 轴)在不修改核心的前提下全局注册。想与颜色主题分开、只改表格的
609
+ * 「外观」时使用 — 一旦注册,任何实例都能用 `grid.setSkin(name)` 选用。内部动作: 把 delta 作为 FORM 专用
610
+ * 校验(混入颜色字面量会破坏色⊥形的正交性,故 **throw**),应用焦点环的无障碍护栏,再以运行时 `<style>` 注入
611
+ * `.og-container[data-og-skin="name"]` 块。
612
+ *
613
+ * @param name - 스킨 id
614
+ *
615
+ * Skin id
616
+ *
617
+ * スキン id
618
+ *
619
+ * 皮肤 id
620
+ *
621
+ * @param delta - FORM 전용 토큰 델타(색값 넣으면 throw)
622
+ *
623
+ * FORM-only token delta (throws on color values)
624
+ *
625
+ * FORM 専用のトークンデルタ(色値を入れると throw)
626
+ *
627
+ * FORM 专用的 token delta(放入颜色值则 throw)
628
+ *
629
+ * @returns 체이닝용 OpenGrid 클래스
630
+ *
631
+ * The OpenGrid class for chaining
632
+ *
633
+ * チェーン用の OpenGrid クラス
634
+ *
635
+ * 用于链式调用的 OpenGrid 类
636
+ *
232
637
  * @example
233
- * // 색은 손대지 않고 형태 토큰만 조정. / Adjusts only form tokens, never color.
638
+ * // Adjusts only form tokens, never color.
234
639
  * OpenGrid.defineSkin('round', { '--og-radius-md': '14px' });
235
640
  * grid.setSkin('round');
236
641
  */
@@ -240,13 +645,37 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
240
645
  * 아이콘 대신 자사 아이콘 팩을 쓰고 싶을 때 role → 아이콘을 통째로 매핑한다 — 이후 모든 인스턴스의
241
646
  * 아이콘 해석에 반영된다. 값은 알려진 아이콘 key 이거나 원시 SVG 본문 마크업. 한 인스턴스만 바꾸려면
242
647
  * `grid.setIcon(role, svg)` 를 쓴다.
243
- * / Register/replace semantic icon role sets (sort arrows, row-delete icon, …) **globally** without
648
+ *
649
+ * Register/replace semantic icon role sets (sort arrows, row-delete icon, …) **globally** without
244
650
  * editing the core — map role → icon in one shot to swap in your own icon pack; it then affects icon
245
651
  * resolution across all instances. Values are known icon keys or raw SVG body markup. To change a
246
652
  * single instance only, use `grid.setIcon(role, svg)`.
247
653
  *
248
- * @param map - role → 아이콘 key 또는 원시 SVG / role → icon key or raw SVG
249
- * @returns 체이닝용 OpenGrid 클래스 / The OpenGrid class for chaining
654
+ * セマンティックなアイコン role のセット(ソート矢印・行削除アイコンなど)を、コアを修正せずに **グローバル** に
655
+ * 差し替えます。標準アイコンの代わりに自社のアイコンパックを使いたいとき、role → アイコンをまとめてマッピング
656
+ * します — 以降、すべてのインスタンスのアイコン解決に反映されます。値は既知のアイコン key、または生の SVG 本体
657
+ * マークアップです。1 つのインスタンスだけを変えるには `grid.setIcon(role, svg)` を使います。
658
+ *
659
+ * 把语义图标 role 集合(排序箭头、行删除图标等)在不修改核心的前提下 **全局** 替换。想用自家图标包代替
660
+ * 默认图标时,把 role → 图标整体映射 — 此后所有实例的图标解析都会反映。值为已知的图标 key,或原始 SVG
661
+ * 主体标记。只想改一个实例时,使用 `grid.setIcon(role, svg)`。
662
+ *
663
+ * @param map - role → 아이콘 key 또는 원시 SVG
664
+ *
665
+ * role → icon key or raw SVG
666
+ *
667
+ * role → アイコン key または生の SVG
668
+ *
669
+ * role → 图标 key 或原始 SVG
670
+ *
671
+ * @returns 체이닝용 OpenGrid 클래스
672
+ *
673
+ * The OpenGrid class for chaining
674
+ *
675
+ * チェーン用の OpenGrid クラス
676
+ *
677
+ * 用于链式调用的 OpenGrid 类
678
+ *
250
679
  * @example
251
680
  * OpenGrid.defineIconSet({ 'sort.asc': 'arrow-up', 'sort.desc': 'arrow-down' });
252
681
  */
@@ -257,110 +686,377 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
257
686
  * 이후 모든 인스턴스가 `grid.setLocale(id)` 로 사용. per-instance 오버라이드는 `grid.setMessage` 참조.
258
687
  * 예) OpenGrid.defineLocale('ja', { contextMenu: { find: '検索' } })
259
688
  *
260
- * / i18n: register/replace a UI-string locale **globally** without editing the core (thin
689
+ * i18n: register/replace a UI-string locale **globally** without editing the core (thin
261
690
  * delegation façade isomorphic to defineSkin/defineIconSet — the canonical entry is
262
691
  * `localeRegistry.register`). Partial catalogs are allowed (ko fills the gaps via fallback).
263
692
  * Any instance can then call `grid.setLocale(id)`. For per-instance overrides see `grid.setMessage`.
264
693
  *
265
- * @param id - 로케일 id(예 'ja') / Locale id (e.g. 'ja')
266
- * @param messages - 메시지 부분/전체 카탈로그 / Partial or full message catalog
267
- * @param opts - `extends`: ko 이전에 시도할 폴백 로케일 / `extends`: fallback locale tried before ko
268
- * @returns 체이닝용 OpenGrid 클래스 / The OpenGrid class for chaining
694
+ * i18n: UI 文字列のロケールを、コアを修正せずに **グローバル** に登録/差し替えします(defineSkin/defineIconSet と
695
+ * 同型の薄い委譲ファサード — 正本は `localeRegistry.register`)。部分カタログを許容します(不足分はフォールバックで
696
+ * ko が埋めます)。以降、すべてのインスタンスが `grid.setLocale(id)` で使用できます。インスタンスごとの
697
+ * オーバーライドは `grid.setMessage` を参照してください。
698
+ *
699
+ * i18n: 把 UI 字符串的区域设置在不修改核心的前提下 **全局** 注册/替换(与 defineSkin/defineIconSet 同型的
700
+ * 薄委托门面 — 正本是 `localeRegistry.register`)。允许部分目录(缺失部分由回退的 ko 填补)。此后所有实例
701
+ * 都能用 `grid.setLocale(id)` 使用。按实例的覆盖请参阅 `grid.setMessage`。
702
+ * 例) OpenGrid.defineLocale('ja', { contextMenu: { find: '検索' } })
703
+ *
704
+ * @param id - 로케일 id(예 'ja')
705
+ *
706
+ * Locale id (e.g. 'ja')
707
+ *
708
+ * ロケール id(例 'ja')
709
+ *
710
+ * 区域设置 id(例 'ja')
711
+ *
712
+ * @param messages - 메시지 부분/전체 카탈로그
713
+ *
714
+ * Partial or full message catalog
715
+ *
716
+ * メッセージの部分/全体カタログ
717
+ *
718
+ * 消息的部分/全体目录
719
+ *
720
+ * @param opts - `extends`: ko 이전에 시도할 폴백 로케일
721
+ *
722
+ * `extends`: fallback locale tried before ko
723
+ *
724
+ * `extends`: ko より前に試すフォールバックロケール
725
+ *
726
+ * `extends`: 比 ko 更先尝试的回退区域设置
727
+ *
728
+ * @returns 체이닝용 OpenGrid 클래스
729
+ *
730
+ * The OpenGrid class for chaining
731
+ *
732
+ * チェーン用の OpenGrid クラス
733
+ *
734
+ * 用于链式调用的 OpenGrid 类
269
735
  */
270
736
  static defineLocale(id: string, messages: PartialLocaleMessages, opts?: {
271
737
  extends?: string;
272
738
  }): typeof OpenGrid;
273
739
  /**
274
- * 그리드를 생성해 컨테이너에 마운트한다. / Create the grid and mount it into the container.
740
+ * 그리드를 생성해 컨테이너에 마운트한다.
275
741
  *
276
- * @param container - CSS 셀렉터 또는 호스트 요소 / CSS selector or host element
277
- * @param options - 그리드 옵션(columns 필수) / Grid options (columns required)
278
- * @example
279
- * const grid = new OpenGrid('#host', { columns: [{ field: 'id', header: 'ID' }] });
742
+ * Create the grid and mount it into the container.
743
+ *
744
+ * グリッドを生成してコンテナにマウントします。
745
+ *
746
+ * 生成表格并挂载到容器。
747
+ *
748
+ * @param container - CSS 셀렉터 또는 호스트 요소
749
+ *
750
+ * CSS selector or host element
751
+ *
752
+ * CSS セレクタまたはホスト要素
753
+ *
754
+ * CSS 选择器或宿主元素
755
+ *
756
+ * @param options - 그리드 옵션(columns 필수)
757
+ *
758
+ * Grid options (columns required)
759
+ *
760
+ * グリッドオプション(columns は必須)
761
+ *
762
+ * 表格选项(columns 必填)
763
+ *
764
+ * @example
765
+ * const grid = new OpenGrid('#host', { columns: [{ field: 'id', header: 'ID' }] });
280
766
  */
281
767
  constructor(container: string | HTMLElement, options: GridOptions<T>);
282
- /** 특정 메서드에 얹은 override 하나만 벗겨 원본 동작으로 되돌린다(다른 override 는 유지). / Peel off one method's override, restoring its original behavior (others stay). */
768
+ /**
769
+ * 특정 메서드에 얹은 override 하나만 벗겨 원본 동작으로 되돌린다(다른 override 는 유지).
770
+ *
771
+ * Peel off one method's override, restoring its original behavior (others stay).
772
+ *
773
+ * 特定のメソッドに重ねた override を 1 つだけ剥がし、元の動作に戻します(ほかの override は維持)。
774
+ *
775
+ * 只剥掉某个方法上叠加的一层 override,恢复原本动作(其他 override 保持不变)。
776
+ */
283
777
  restore(name: string): this;
284
- /** 얹어 둔 모든 override·strategy 를 한 번에 걷어 낸다. destroy 가 자동으로 호출하므로 보통 직접 부를 일은 없다. / Remove every override & strategy at once; destroy calls it automatically, so you rarely need it directly. */
778
+ /**
779
+ * 얹어 둔 모든 override·strategy 를 한 번에 걷어 낸다. destroy 가 자동으로 호출하므로 보통 직접 부를 일은 없다.
780
+ *
781
+ * Remove every override & strategy at once; destroy calls it automatically, so you rarely need it directly.
782
+ *
783
+ * 重ねてあるすべての override・strategy を一度に取り除きます。destroy が自動的に呼ぶため、通常は直接呼ぶ必要はありません。
784
+ *
785
+ * 把叠加的所有 override、strategy 一次性撤除。destroy 会自动调用,通常无需直接调用。
786
+ */
285
787
  restoreAll(): this;
286
- /** 해당 메서드가 지금 override 로 감싸여 있는지 확인한다(조건부로 override 를 얹기 전 점검용). / Check whether the method is currently wrapped by an override (handy before layering conditionally). */
788
+ /**
789
+ * 해당 메서드가 지금 override 로 감싸여 있는지 확인한다(조건부로 override 를 얹기 전 점검용).
790
+ *
791
+ * Check whether the method is currently wrapped by an override (handy before layering conditionally).
792
+ *
793
+ * そのメソッドが現在 override で包まれているかを確認します(条件付きで override を重ねる前の点検用)。
794
+ *
795
+ * 确认该方法当前是否被 override 包裹(便于在有条件地叠加 override 之前检查)。
796
+ */
287
797
  hasOverride(name: string): boolean;
288
- /** 현재 override 가 걸린 메서드 이름들을 돌려준다(무엇을 손댔는지 감사·디버깅용). / Names of currently overridden methods — for auditing/debugging what you have touched. */
798
+ /**
799
+ * 현재 override 가 걸린 메서드 이름들을 돌려준다(무엇을 손댔는지 감사·디버깅용).
800
+ *
801
+ * Names of currently overridden methods — for auditing/debugging what you have touched.
802
+ *
803
+ * 現在 override が掛かっているメソッド名を返します(何に手を入れたかの監査・デバッグ用)。
804
+ *
805
+ * 返回当前被 override 的方法名(用于审计、调试改动了什么)。
806
+ */
289
807
  getOverrideNames(): string[];
290
- /** strategy 슬롯에 꽂힌 함수를 읽는다. 미등록이면 넘긴 fallback 을 그대로 돌려주므로 호출부는 항상 함수를 얻는다. / Read the function plugged into a strategy slot; returns your fallback when unset, so callers always get a function. */
808
+ /**
809
+ * strategy 슬롯에 꽂힌 함수를 읽는다. 미등록이면 넘긴 fallback 을 그대로 돌려주므로 호출부는 항상 함수를 얻는다.
810
+ *
811
+ * Read the function plugged into a strategy slot; returns your fallback when unset, so callers always get a function.
812
+ *
813
+ * strategy スロットに差し込まれた関数を読み取ります。未登録の場合は渡した fallback をそのまま返すため、呼び出し側は常に関数を得られます。
814
+ *
815
+ * 读取插入 strategy 槽的函数。未注册时原样返回传入的 fallback,因此调用方总能得到一个函数。
816
+ */
291
817
  getStrategy<F extends Function>(slot: string, fallback: F): F;
292
818
  private _mount;
293
819
  private _initContextMenu;
294
820
  /**
295
- * 컨텍스트 메뉴를 지정 좌표에 연다. / Open the context menu at the event position.
821
+ * 컨텍스트 메뉴를 지정 좌표에 연다.
822
+ *
823
+ * Open the context menu at the event position.
824
+ *
825
+ * コンテキストメニューを指定座標に開きます。
826
+ *
827
+ * 在指定坐标打开上下文菜单。
828
+ *
829
+ * @param e - 좌표를 제공할 마우스 이벤트
830
+ *
831
+ * Mouse event providing coordinates
832
+ *
833
+ * 座標を提供するマウスイベント
834
+ *
835
+ * 提供坐标的鼠标事件
836
+ *
837
+ * @param items - 커스텀 메뉴 항목(생략 시 기본 메뉴)
838
+ *
839
+ * Custom items (default menu when omitted)
840
+ *
841
+ * カスタムメニュー項目(省略時は既定メニュー)
296
842
  *
297
- * @param e - 좌표를 제공할 마우스 이벤트 / Mouse event providing coordinates
298
- * @param items - 커스텀 메뉴 항목(생략 시 기본 메뉴) / Custom items (default menu when omitted)
843
+ * 自定义菜单项(省略时为默认菜单)
299
844
  */
300
845
  openContextMenu(e: MouseEvent, items?: import('./types').ContextMenuItem[]): void;
301
- /** 컨텍스트 메뉴를 닫는다. / Close the context menu. */
846
+ /**
847
+ * 컨텍스트 메뉴를 닫는다.
848
+ *
849
+ * Close the context menu.
850
+ *
851
+ * コンテキストメニューを閉じます。
852
+ *
853
+ * 关闭上下文菜单。
854
+ */
302
855
  closeContextMenu(): void;
303
856
  /**
304
857
  * 상위 선택이 하위 선택지를 좁히는 연동(캐스케이딩) 필터 셀렉트 패널을 붙이거나 뗀다. 예를 들어 "국가 →
305
858
  * 도시"처럼 앞 컬럼 값에 따라 뒷 컬럼 후보가 달라지는 상단 필터 UI가 필요할 때 config 로 설정하고,
306
859
  * `null` 을 넘기면 패널을 제거한다.
307
- * / Attach or detach a cascading filter-select panel where each choice narrows the next (e.g.
860
+ *
861
+ * Attach or detach a cascading filter-select panel where each choice narrows the next (e.g.
308
862
  * "country → city", so a later column's options depend on the earlier value). Pass a config to set
309
863
  * it up, or `null` to remove the panel.
310
864
  *
311
- * @param config - 패널 구성 또는 제거용 null / Panel config, or null to remove
865
+ * 上位の選択が下位の選択肢を絞り込む連動(カスケーディング)フィルターセレクトパネルを取り付け、または取り外します。
866
+ * たとえば「国 → 都市」のように、前の列の値によって後ろの列の候補が変わる上部フィルター UI が必要なときに config で
867
+ * 設定し、`null` を渡すとパネルを削除します。
868
+ *
869
+ * 装上或卸下上位选择收窄下位选项的联动(级联)筛选选择面板。例如需要「国家 → 城市」这类、后一列的候选
870
+ * 随前一列的值而变化的顶部筛选 UI 时,用 config 设置;传入 `null` 则移除面板。
871
+ *
872
+ * @param config - 패널 구성 또는 제거용 null
873
+ *
874
+ * Panel config, or null to remove
875
+ *
876
+ * パネル構成、または削除用の null
877
+ *
878
+ * 面板配置,或用于移除的 null
312
879
  */
313
880
  setFilterSelect(config: FilterSelectConfig | null): void;
314
881
  /**
315
882
  * 생성 후에 그리드 옵션 일부만 바꿔 끼운다. 그리드를 다시 만들지 않고 컨텍스트 메뉴 구성이나 그룹핑
316
883
  * 기준 같은 설정을 바꾸고 싶을 때 쓴다 — 넘긴 옵션만 덮어쓴 뒤, 영향받는 부분(contextMenu 재초기화·
317
884
  * groupBy 재구성 등)만 골라 갱신하고 다시 그린다.
318
- * / Swap in part of the grid options after construction. Use it to change settings like the context
885
+ *
886
+ * Swap in part of the grid options after construction. Use it to change settings like the context
319
887
  * menu or grouping keys without recreating the grid — only the passed options are overwritten, then
320
888
  * just the affected parts (re-init contextMenu, rebuild groupBy, …) are refreshed and re-rendered.
321
889
  *
322
- * @param opts - 갱신할 옵션 부분집합 / Subset of options to update
890
+ * 生成後にグリッドオプションの一部だけを差し替えます。グリッドを作り直さずに、コンテキストメニューの構成や
891
+ * グループ化の基準といった設定を変えたいときに使います — 渡したオプションだけを上書きしたあと、影響を受ける部分
892
+ * (contextMenu の再初期化・groupBy の再構成など)だけを選んで更新し、描画し直します。
893
+ *
894
+ * 生成后只替换表格选项的一部分。想在不重建表格的情况下,改动上下文菜单的构成或分组基准这类设置时使用 —
895
+ * 只覆盖传入的选项,然后仅挑出受影响的部分(contextMenu 的重新初始化、groupBy 的重新构建等)更新并重新绘制。
896
+ *
897
+ * @param opts - 갱신할 옵션 부분집합
898
+ *
899
+ * Subset of options to update
900
+ *
901
+ * 更新するオプションの部分集合
902
+ *
903
+ * 要更新的选项子集
323
904
  */
324
905
  setOptions(opts: Partial<GridOptions<T>>): void;
325
906
  /**
326
- * 컬럼 마스킹 ON/OFF 전환. / Toggle column masking on/off.
327
- * enabled=true → 마스킹 적용 (기본 상태) / apply masking (default state)
328
- * enabled=false → 컬럼 전체 마스킹 해제 (원문 표시) / reveal the whole column (show raw values)
907
+ * 컬럼 마스킹 ON/OFF 전환.
908
+ * enabled=true → 마스킹 적용 (기본 상태)
909
+ * enabled=false → 컬럼 전체 마스킹 해제 (원문 표시)
910
+ *
911
+ * Toggle column masking on/off.
912
+ * enabled=true → apply masking (default state)
913
+ * enabled=false → reveal the whole column (show raw values)
914
+ *
915
+ * 列マスキングの ON/OFF 切り替え。
916
+ * enabled=true → マスキングを適用(既定の状態)
917
+ * enabled=false → 列全体のマスキングを解除(原文を表示)
918
+ *
919
+ * 列掩码的 ON/OFF 切换。
920
+ * enabled=true → 应用掩码(默认状态)
921
+ * enabled=false → 解除整列的掩码(显示原文)
922
+ *
923
+ * @param field - 대상 컬럼 field
924
+ *
925
+ * Target column field
926
+ *
927
+ * 対象となる列の field
928
+ *
929
+ * 目标列的 field
329
930
  *
330
- * @param field - 대상 컬럼 field / Target column field
331
- * @param enabled - 마스킹 활성 여부 / Whether masking is active
931
+ * @param enabled - 마스킹 활성 여부
932
+ *
933
+ * Whether masking is active
934
+ *
935
+ * マスキングを有効にするかどうか
936
+ *
937
+ * 是否启用掩码
332
938
  */
333
939
  setMaskEnabled(field: string, enabled: boolean): void;
334
- /** 현재 컬럼 마스킹 활성 여부 반환. true=마스킹 중, false=해제됨 / Return whether masking is active for the column (true = masked, false = revealed). */
940
+ /**
941
+ * 현재 컬럼 마스킹 활성 여부 반환. true=마스킹 중, false=해제됨
942
+ *
943
+ * Return whether masking is active for the column (true = masked, false = revealed).
944
+ *
945
+ * 現在の列マスキングが有効かどうかを返します。true=マスキング中、false=解除済み。
946
+ *
947
+ * 返回当前列的掩码是否启用。true=掩码中,false=已解除。
948
+ */
335
949
  getMaskEnabled(field: string): boolean;
336
950
  private _initWorksheets;
337
951
  private _loadWorksheetState;
338
952
  /**
339
- * 워크시트(탭)를 추가한다. / Add a worksheet (tab).
953
+ * 워크시트(탭)를 추가한다.
340
954
  *
341
- * @param name - 시트 이름 / Sheet name
342
- * @param columns - 시트 전용 컬럼(생략 시 그리드 columns) / Sheet columns (grid columns when omitted)
343
- * @param data - 시트 데이터 / Sheet data
955
+ * Add a worksheet (tab).
956
+ *
957
+ * ワークシート(タブ)を追加します。
958
+ *
959
+ * 添加工作表(标签页)。
960
+ *
961
+ * @param name - 시트 이름
962
+ *
963
+ * Sheet name
964
+ *
965
+ * シート名
966
+ *
967
+ * 工作表名
968
+ *
969
+ * @param columns - 시트 전용 컬럼(생략 시 그리드 columns)
970
+ *
971
+ * Sheet columns (grid columns when omitted)
972
+ *
973
+ * シート専用の列(省略時はグリッドの columns)
974
+ *
975
+ * 工作表专用的列(省略时为表格的 columns)
976
+ *
977
+ * @param data - 시트 데이터
978
+ *
979
+ * Sheet data
980
+ *
981
+ * シートのデータ
982
+ *
983
+ * 工作表的数据
344
984
  */
345
985
  addWorksheet(name: string, columns?: import('./types').ColumnDef<T>[], data?: T[]): void;
346
- /** 워크시트를 제거한다. / Remove a worksheet. */
986
+ /**
987
+ * 워크시트를 제거한다.
988
+ *
989
+ * Remove a worksheet.
990
+ *
991
+ * ワークシートを削除します。
992
+ *
993
+ * 删除工作表。
994
+ */
347
995
  removeWorksheet(name: string): void;
348
- /** 지정 워크시트로 전환한다. / Switch to the given worksheet. */
996
+ /**
997
+ * 지정 워크시트로 전환한다.
998
+ *
999
+ * Switch to the given worksheet.
1000
+ *
1001
+ * 指定したワークシートに切り替えます。
1002
+ *
1003
+ * 切换到指定的工作表。
1004
+ */
349
1005
  switchWorksheet(name: string): void;
350
- /** 워크시트 이름을 변경한다. / Rename a worksheet. */
1006
+ /**
1007
+ * 워크시트 이름을 변경한다.
1008
+ *
1009
+ * Rename a worksheet.
1010
+ *
1011
+ * ワークシート名を変更します。
1012
+ *
1013
+ * 修改工作表名。
1014
+ */
351
1015
  renameWorksheet(oldName: string, newName: string): void;
352
- /** 워크시트 상태 스냅샷 조회(없으면 undefined). / Get a worksheet state snapshot (undefined when absent). */
1016
+ /**
1017
+ * 워크시트 상태 스냅샷 조회(없으면 undefined).
1018
+ *
1019
+ * Get a worksheet state snapshot (undefined when absent).
1020
+ *
1021
+ * ワークシート状態のスナップショットを取得(存在しない場合は undefined)。
1022
+ *
1023
+ * 获取工作表状态的快照(不存在时为 undefined)。
1024
+ */
353
1025
  getWorksheet(name: string): import('./types').WorksheetState<T> | undefined;
354
- /** 워크시트 이름 목록. / List of worksheet names. */
1026
+ /**
1027
+ * 워크시트 이름 목록.
1028
+ *
1029
+ * List of worksheet names.
1030
+ *
1031
+ * ワークシート名の一覧。
1032
+ *
1033
+ * 工作表名的列表。
1034
+ */
355
1035
  getWorksheetNames(): string[];
356
- /** 모든 워크시트를 다중 시트 엑셀로 내보낸다. / Export all worksheets as a multi-sheet Excel file. */
1036
+ /**
1037
+ * 모든 워크시트를 다중 시트 엑셀로 내보낸다.
1038
+ *
1039
+ * Export all worksheets as a multi-sheet Excel file.
1040
+ *
1041
+ * すべてのワークシートを複数シートの Excel として書き出します。
1042
+ *
1043
+ * 把所有工作表导出为多工作表的 Excel。
1044
+ */
357
1045
  exportSheetsExcel(filename?: string): void;
358
1046
  private _onResize;
359
1047
  private _recalcWidths;
360
1048
  private _renderHeader;
361
1049
  private _syncHeaderLayout;
362
1050
  private _doRender;
363
- /** F2(§4.5/§6.1): masterDetail.enabled 아니면 undefined(GridRenderer 는 기존 경로 그대로). */
1051
+ /**
1052
+ * F2(§4.5/§6.1): masterDetail.enabled 아니면 undefined(GridRenderer 는 기존 경로 그대로).
1053
+ *
1054
+ * F2 (§4.5/§6.1): undefined unless masterDetail.enabled (GridRenderer keeps its existing path).
1055
+ *
1056
+ * F2(§4.5/§6.1): masterDetail.enabled でなければ undefined(GridRenderer は既存の経路のまま)。
1057
+ *
1058
+ * F2(§4.5/§6.1): 若非 masterDetail.enabled 则为 undefined(GridRenderer 保持既有路径不变)。
1059
+ */
364
1060
  private _buildDetailRenderContext;
365
1061
  private _handleGroupToggle;
366
1062
  private _visRange;
@@ -378,25 +1074,91 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
378
1074
  private _handleFilterIconClick;
379
1075
  private _handleAllCheck;
380
1076
  private _handleRowDrop;
381
- /** @internal 드래그/셔틀이 참조하는 바디 엘리먼트 (레지스트리 해석용) / Body element referenced by drag/shuttle (registry resolution). */
1077
+ /**
1078
+ * @internal 드래그/셔틀이 참조하는 바디 엘리먼트 (레지스트리 해석용)
1079
+ *
1080
+ * Body element referenced by drag/shuttle (registry resolution).
1081
+ *
1082
+ * ドラッグ/シャトルが参照するボディ要素(レジストリ解決用)。
1083
+ *
1084
+ * 拖拽/穿梭所引用的 body 元素(用于注册表解析)。
1085
+ */
382
1086
  _crossBodyEl(): HTMLElement;
383
- /** fromIndex 를 잡고 드래그할 때 함께 이동할 행 집합 (다중선택에 포함되면 선택 전체) */
1087
+ /**
1088
+ * fromIndex 를 잡고 드래그할 때 함께 이동할 행 집합 (다중선택에 포함되면 선택 전체)
1089
+ *
1090
+ * The set of rows that move together when dragging by fromIndex (the whole selection when fromIndex is part of a multi-selection).
1091
+ *
1092
+ * fromIndex をつかんでドラッグするときに一緒に移動する行の集合(複数選択に含まれる場合は選択全体)。
1093
+ *
1094
+ * 抓住 fromIndex 拖拽时一起移动的行集合(若包含在多选中则为整个选择)。
1095
+ */
384
1096
  private _dragRowSet;
385
1097
  /**
386
1098
  * 이 그리드의 행들을 다른 그리드로 이동(move)한다. 드래그·화살표 셔틀 공통 경로.
387
1099
  * 3단계 이벤트(before→after→complete)와 crossGridMapping(필드 매핑)을 적용한다.
388
- * / Move rows from this grid to another grid (shared path for drag and arrow shuttle).
1100
+ *
1101
+ * Move rows from this grid to another grid (shared path for drag and arrow shuttle).
389
1102
  * Applies the three-phase events (before→after→complete) and crossGridMapping (field mapping).
390
1103
  *
391
- * @param target - 대상 그리드 / Target grid
392
- * @param sourceIndexes - 이동할 소스 행 인덱스들 / Source row indexes to move
393
- * @param targetIndex - 삽입 시작 인덱스(생략 시 끝) / Insertion start index (end when omitted)
394
- * @returns 이동 성공 여부 / Whether the move succeeded
1104
+ * このグリッドの行を別のグリッドへ移動(move)します。ドラッグ・矢印シャトル共通の経路です。
1105
+ * 3 段階イベント(before→after→complete)と crossGridMapping(フィールドマッピング)を適用します。
1106
+ *
1107
+ * 把这个表格的行移动(move)到另一个表格。拖拽与箭头穿梭的公共路径。
1108
+ * 应用 3 阶段事件(before→after→complete)与 crossGridMapping(字段映射)。
1109
+ *
1110
+ * @param target - 대상 그리드
1111
+ *
1112
+ * Target grid
1113
+ *
1114
+ * 対象グリッド
1115
+ *
1116
+ * 目标表格
1117
+ *
1118
+ * @param sourceIndexes - 이동할 소스 행 인덱스들
1119
+ *
1120
+ * Source row indexes to move
1121
+ *
1122
+ * 移動するソース行のインデックス
1123
+ *
1124
+ * 要移动的源行索引
1125
+ *
1126
+ * @param targetIndex - 삽입 시작 인덱스(생략 시 끝)
1127
+ *
1128
+ * Insertion start index (end when omitted)
1129
+ *
1130
+ * 挿入開始インデックス(省略時は末尾)
1131
+ *
1132
+ * 插入的起始索引(省略时为末尾)
1133
+ *
1134
+ * @returns 이동 성공 여부
1135
+ *
1136
+ * Whether the move succeeded
1137
+ *
1138
+ * 移動が成功したかどうか
1139
+ *
1140
+ * 移动是否成功
395
1141
  */
396
1142
  moveRowsTo(target: OpenGridInstance<T>, sourceIndexes: number[], targetIndex?: number): Promise<boolean>;
397
- /** 체크된 행을 다른 그리드로 이동 (화살표 셔틀용). 체크 없으면 무시. / Move checked rows to another grid (arrow-shuttle use). No-op when nothing is checked. */
1143
+ /**
1144
+ * 체크된 행을 다른 그리드로 이동 (화살표 셔틀용). 체크 없으면 무시.
1145
+ *
1146
+ * Move checked rows to another grid (arrow-shuttle use). No-op when nothing is checked.
1147
+ *
1148
+ * チェックされた行を別のグリッドへ移動(矢印シャトル用)。チェックがなければ何もしません。
1149
+ *
1150
+ * 把勾选的行移动到另一个表格(用于箭头穿梭)。没有勾选则不做任何事。
1151
+ */
398
1152
  moveCheckedTo(target: OpenGridInstance<T>): Promise<boolean>;
399
- /** 행 위치 이동(드롭 경로에서 실행). / Move a row to a new position (executed on the drop path). */
1153
+ /**
1154
+ * 행 위치 이동(드롭 경로에서 실행).
1155
+ *
1156
+ * Move a row to a new position (executed on the drop path).
1157
+ *
1158
+ * 行の位置を移動(ドロップ経路で実行)。
1159
+ *
1160
+ * 移动行的位置(在拖放路径中执行)。
1161
+ */
400
1162
  reorderRow(fromIndex: number, toIndex: number): void;
401
1163
  private _handleColResize;
402
1164
  private _handleKeyDown;
@@ -407,34 +1169,101 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
407
1169
  * 그리드의 데이터 전체를 새 배열로 갈아끼운다. 서버에서 목록을 새로 받아오는 등 데이터를 통째로 바꿀 때
408
1170
  * 쓴다. 행 식별자(id)를 새로 발급하므로 기존 행에 걸려 있던 셀 수식 상태는 이때 초기화된다 — 일부만 바꿀
409
1171
  * 때는 `writeCell`/`insertRow`/`deleteRow` 쪽이 상태를 보존한다.
410
- * / Replace the whole data set with a new array. Use it when the data changes entirely (e.g. a fresh
1172
+ *
1173
+ * Replace the whole data set with a new array. Use it when the data changes entirely (e.g. a fresh
411
1174
  * list from the server). It reissues row ids, so any existing cell-formula state is reset here — for
412
1175
  * partial changes prefer `writeCell`/`insertRow`/`deleteRow`, which preserve state.
413
1176
  *
414
- * @param data - 새 행 배열 / New array of rows
1177
+ * グリッドのデータ全体を新しい配列に差し替えます。サーバーから一覧を取り直すなど、データをまるごと入れ替えるときに
1178
+ * 使います。行識別子(id)を発行し直すため、既存の行に掛かっていたセル数式の状態はこのとき初期化されます — 一部だけを
1179
+ * 変えるときは `writeCell`/`insertRow`/`deleteRow` のほうが状態を保持します。
1180
+ *
1181
+ * 把表格的全部数据换成新数组。从服务器重新取回列表等、要整体替换数据时使用。因为会重新签发行标识符(id),
1182
+ * 挂在既有行上的单元格公式状态会在此时初始化 — 只改一部分时,`writeCell`/`insertRow`/`deleteRow`
1183
+ * 这一侧会保留状态。
1184
+ *
1185
+ * @param data - 새 행 배열
1186
+ *
1187
+ * New array of rows
1188
+ *
1189
+ * 新しい行の配列
1190
+ *
1191
+ * 新的行数组
1192
+ *
415
1193
  * @example
416
1194
  * grid.setData([{ name: 'Kim' }, { name: 'Lee' }]);
417
1195
  */
418
1196
  setData(data: T[]): void;
419
- /** 지금 화면에 보이는 순서·범위 그대로의 데이터 배열을 돌려준다(정렬·필터가 반영된 결과). 사용자가 보고 있는 그대로를 내보내거나 집계할 때 쓴다. / Return the data array as currently shown (sort/filter applied) — use it to export or aggregate exactly what the user sees. */
1197
+ /**
1198
+ * 지금 화면에 보이는 순서·범위 그대로의 데이터 배열을 돌려준다(정렬·필터가 반영된 결과). 사용자가 보고 있는 그대로를 내보내거나 집계할 때 쓴다.
1199
+ *
1200
+ * Return the data array as currently shown (sort/filter applied) — use it to export or aggregate exactly what the user sees.
1201
+ *
1202
+ * いま画面に見えている順序・範囲そのままのデータ配列を返します(ソート・フィルターが反映された結果)。ユーザーが見ているままを書き出したり集計したりするときに使います。
1203
+ *
1204
+ * 返回当前画面上所见的顺序、范围原样的数据数组(已反映排序、筛选的结果)。想把用户所见的内容原样导出或聚合时使用。
1205
+ */
420
1206
  getData(): T[];
421
- /** 정렬·필터를 걷어 낸 원본 데이터 배열을 돌려준다. "원래 넣었던 전체 데이터"가 필요할 때 getData() 대신 쓴다. / Return the original data array before sort/filter — use it instead of getData() when you need the full, unfiltered set. */
1207
+ /**
1208
+ * 정렬·필터를 걷어 낸 원본 데이터 배열을 돌려준다. "원래 넣었던 전체 데이터"가 필요할 때 getData() 대신 쓴다.
1209
+ *
1210
+ * Return the original data array before sort/filter — use it instead of getData() when you need the full, unfiltered set.
1211
+ *
1212
+ * ソート・フィルターを取り除いた元のデータ配列を返します。「もともと入れた全データ」が必要なときに getData() の代わりに使います。
1213
+ *
1214
+ * 返回去掉排序、筛选的原始数据数组。需要「原本放入的全部数据」时,代替 getData() 使用。
1215
+ */
422
1216
  getSourceRows(): T[];
423
- /** 기존 데이터 뒤에 행들을 이어 붙인다. 전체를 setData 로 갈아끼우지 않고 뒤에만 덧붙일 때 쓴다(무한 스크롤·추가 로드 등). / Append rows after the existing data — for adding to the tail without replacing everything via setData (infinite scroll, load-more, …). */
1217
+ /**
1218
+ * 기존 데이터 뒤에 행들을 이어 붙인다. 전체를 setData 로 갈아끼우지 않고 뒤에만 덧붙일 때 쓴다(무한 스크롤·추가 로드 등).
1219
+ *
1220
+ * Append rows after the existing data — for adding to the tail without replacing everything via setData (infinite scroll, load-more, …).
1221
+ *
1222
+ * 既存データの後ろに行を継ぎ足します。全体を setData で差し替えずに末尾だけ追加するときに使います(無限スクロール・追加ロードなど)。
1223
+ *
1224
+ * 在既有数据后面接上行。不用 setData 替换整体、只在末尾追加时使用(无限滚动、追加加载等)。
1225
+ */
424
1226
  pushData(data: T[]): void;
425
- /** 기존 데이터 앞에 행들을 끼워 넣는다(최신 항목을 맨 위로 올릴 때 등). / Prepend rows before the existing data (e.g. to push newest items to the top). */
1227
+ /**
1228
+ * 기존 데이터 앞에 행들을 끼워 넣는다(최신 항목을 맨 위로 올릴 때 등).
1229
+ *
1230
+ * Prepend rows before the existing data (e.g. to push newest items to the top).
1231
+ *
1232
+ * 既存データの前に行を挿し込みます(最新の項目を先頭に上げるときなど)。
1233
+ *
1234
+ * 在既有数据前面插入行(例如把最新的项目提到最前时)。
1235
+ */
426
1236
  prefixData(data: T[]): void;
427
1237
  /**
428
1238
  * 조건부서식(CF) 규칙을 설정한다 — 데이터바·히트맵·아이콘셋을 렌더 경로에 배선한다.
429
1239
  * CF 는 opt-in 이라 첫 호출 때 CF 엔진(cf/**)을 **동적 import** 로 조립한다(베이스 번들 무증가, 별 청크).
430
1240
  * 규칙이 걸린 컬럼마다 컬럼 통계를 1회 캐시 계산(per-render 재계산 금지)한 뒤 재렌더한다.
431
1241
  * `rules=[]` 를 넘기면 CF 를 해제한다(엔진·통계 캐시 clear + 잔재 제거 재렌더).
432
- * / Set conditional-formatting rules — wires data-bars/heatmaps/icon-sets into the render path.
1242
+ *
1243
+ * Set conditional-formatting rules — wires data-bars/heatmaps/icon-sets into the render path.
433
1244
  * CF is opt-in; the CF engine (cf/**) is assembled via **dynamic import** on first call (no base-bundle
434
1245
  * growth, separate chunk). Column stats are cached once per rule-bearing column (never re-computed
435
1246
  * per render), then a re-render paints them. Passing `rules=[]` clears CF (engine/cache reset + residue-stripping re-render).
436
1247
  *
437
- * @param rules - CF 규칙 배열(빈 배열이면 해제) / CF rule array (empty array clears CF)
1248
+ * 条件付き書式(CF)のルールを設定します — データバー・ヒートマップ・アイコンセットをレンダー経路に配線します。
1249
+ * CF は opt-in のため、初回呼び出し時に CF エンジン(cf/**)を **動的 import** で組み立てます(ベースバンドルは
1250
+ * 増えず、別チャンク)。ルールが掛かった列ごとに列統計を 1 回だけキャッシュ計算し(レンダーごとの再計算は禁止)、
1251
+ * そのうえで再レンダーします。`rules=[]` を渡すと CF を解除します(エンジン・統計キャッシュを clear + 残滓を
1252
+ * 取り除く再レンダー)。
1253
+ *
1254
+ * 设置条件格式(CF)的规则 — 把数据条、热力图、图标集配线到渲染路径。
1255
+ * CF 为 opt-in,首次调用时以 **动态 import** 组装 CF 引擎(cf/**)(基础包不增加,独立分块)。
1256
+ * 对每个挂有规则的列只缓存计算 1 次列统计(禁止每次渲染重算),然后重新渲染。
1257
+ * 传入 `rules=[]` 则解除 CF(clear 引擎与统计缓存 + 去除残留的重新渲染)。
1258
+ *
1259
+ * @param rules - CF 규칙 배열(빈 배열이면 해제)
1260
+ *
1261
+ * CF rule array (empty array clears CF)
1262
+ *
1263
+ * CF ルールの配列(空配列なら解除)
1264
+ *
1265
+ * CF 规则的数组(空数组则解除)
1266
+ *
438
1267
  * @example
439
1268
  * await grid.setConditionalFormat([
440
1269
  * { id: 'bar', when: { type: 'compare', op: '>=', a: 0 }, encode: { kind: 'bar', axis: 'zero' }, scope: { columnId: 'amount' }, priority: 0 },
@@ -444,7 +1273,14 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
444
1273
  /**
445
1274
  * CF 규칙이 걸린 컬럼마다 현재 데이터로 컬럼 통계를 계산해 캐시한다(per-render 재계산 금지의 근거).
446
1275
  * 통계 계산기는 setConditionalFormat 에서 cf/ 동적 청크로부터 보관한 참조를 동기 사용한다.
447
- * / Recompute & cache per-column CF stats using the computer captured from the cf/ dynamic chunk.
1276
+ *
1277
+ * Recompute & cache per-column CF stats using the computer captured from the cf/ dynamic chunk.
1278
+ *
1279
+ * CF ルールが掛かった列ごとに、現在のデータで列統計を計算してキャッシュします(レンダーごとの再計算を禁止できる根拠)。
1280
+ * 統計計算機は、setConditionalFormat で cf/ の動的チャンクから保持した参照を同期的に使います。
1281
+ *
1282
+ * 对每个挂有 CF 规则的列,用当前数据计算列统计并缓存(禁止每次渲染重算的依据)。
1283
+ * 统计计算器同步使用 setConditionalFormat 中从 cf/ 动态分块保留下来的引用。
448
1284
  */
449
1285
  private _recomputeCFStats;
450
1286
  /**
@@ -452,160 +1288,527 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
452
1288
  * CF 와 동일하게 첫 호출 시에만 realtime/ 를 동적 import(별 청크·베이스 번들 무증가). 델타는 기존
453
1289
  * 단일 쓰기 경로(MutationService)를 재사용해 적용되므로 증분=전체 불변식·수식 재계산·차트 라이브
454
1290
  * 갱신(dataChange 구독)을 자연 상속한다. 재호출 시 이전 소스는 detach 후 교체.
455
- * / Wire a realtime source (polling/streaming/custom — any `IRealtimeSource` via DI). Like CF, the
456
- * realtime/ chunk is dynamically imported only on first call (separate chunk; base bundle unchanged).
457
- * Deltas reuse the existing single write path (MutationService), inheriting the incremental=full
458
- * invariant, formula recompute, and live chart refresh (dataChange subscription). Re-calling
459
- * detaches and replaces the previous source.
460
- *
461
- * @param source - 실시간 소스(예: `new PollingSource({...})`) / Realtime source (e.g. `new PollingSource({...})`)
462
- * @param opts - 백프레셔·신선도·SR 옵션(전부 옵션) / Backpressure/freshness/SR options (all optional)
463
- * @returns 배선된 컨트롤러(`.connection`·`.backpressureStats`·`.onConnection`·`.detach()`) / The wired controller
1291
+ *
1292
+ * Wire a realtime source (polling/streaming/custom — any `IRealtimeSource` via DI). Like CF, the
1293
+ * realtime/ chunk is dynamically imported only on first call (separate chunk; base bundle unchanged).
1294
+ * Deltas reuse the existing single write path (MutationService), inheriting the incremental=full
1295
+ * invariant, formula recompute, and live chart refresh (dataChange subscription). Re-calling
1296
+ * detaches and replaces the previous source.
1297
+ *
1298
+ * リアルタイムデータソースをグリッドに配線します(ポーリング/ストリーミング/カスタム — `IRealtimeSource` の実装で
1299
+ * あれば何でも DI 可能)。CF と同じく、初回呼び出し時にのみ realtime/ を動的 import します(別チャンク・ベース
1300
+ * バンドルは増えません)。デルタは既存の単一書き込み経路(MutationService)を再利用して適用されるため、増分=全体の
1301
+ * 不変条件・数式の再計算・チャートのライブ更新(dataChange の購読)を自然に継承します。再度呼び出すと、以前の
1302
+ * ソースは detach してから差し替えられます。
1303
+ *
1304
+ * 把实时数据源配线到表格(轮询/流式/自定义 — 只要是 `IRealtimeSource` 的实现都可以 DI)。
1305
+ * 与 CF 相同,仅在首次调用时动态 import realtime/(独立分块、基础包不增加)。增量复用既有的单一写入路径
1306
+ * (MutationService)来应用,因此自然继承增量=整体的不变条件、公式的重算、图表的实时更新(dataChange 的订阅)。
1307
+ * 再次调用时,先 detach 之前的源再替换。
1308
+ *
1309
+ * @param source - 실시간 소스(예: `new PollingSource({...})`)
1310
+ *
1311
+ * Realtime source (e.g. `new PollingSource({...})`)
1312
+ *
1313
+ * リアルタイムソース(例: `new PollingSource({...})`)
1314
+ *
1315
+ * 实时源(例: `new PollingSource({...})`)
1316
+ *
1317
+ * @param opts - 백프레셔·신선도·SR 옵션(전부 옵션)
1318
+ *
1319
+ * Backpressure/freshness/SR options (all optional)
1320
+ *
1321
+ * バックプレッシャー・鮮度・SR のオプション(すべて任意)
1322
+ *
1323
+ * 背压、新鲜度、SR 的选项(全部可选)
1324
+ *
1325
+ * @returns 배선된 컨트롤러(`.connection`·`.backpressureStats`·`.onConnection`·`.detach()`)
1326
+ *
1327
+ * The wired controller
1328
+ *
1329
+ * 配線されたコントローラ(`.connection`・`.backpressureStats`・`.onConnection`・`.detach()`)
1330
+ *
1331
+ * 配线好的控制器(`.connection`、`.backpressureStats`、`.onConnection`、`.detach()`)
1332
+ *
464
1333
  * @example
465
1334
  * const src = new PollingSource({ intervalMs: 1000, fetcher: async () => ({ kind: 'delta', seq, cells }) });
466
1335
  * const rt = await grid.setRealtimeSource(src);
467
1336
  * rt.onConnection((s) => console.log(s.status));
468
1337
  */
469
1338
  setRealtimeSource(source: IRealtimeSource<T>, opts?: RealtimeWireOptions): Promise<RealtimeController<T>>;
470
- /** 실시간 소스 배선을 해제한다(구독·타이머·소켓 정리, 멱등). / Disconnect the realtime source (teardown; idempotent). */
1339
+ /**
1340
+ * 실시간 소스 배선을 해제한다(구독·타이머·소켓 정리, 멱등).
1341
+ *
1342
+ * Disconnect the realtime source (teardown; idempotent).
1343
+ *
1344
+ * リアルタイムソースの配線を解除します(購読・タイマー・ソケットの後片付け、冪等)。
1345
+ *
1346
+ * 解除实时源的配线(清理订阅、定时器、套接字,幂等)。
1347
+ */
471
1348
  disconnectRealtime(): void;
472
- /** 데이터만 전부 비운다 — 컬럼 정의와 옵션은 그대로 두고 행만 0건으로 만든다. 같은 표 구조를 유지한 채 내용만 갈아엎기 전에 쓴다. / Empty just the data — keep column defs and options, drop all rows to zero. Use it before reloading content into the same table shape. */
1349
+ /**
1350
+ * 데이터만 전부 비운다 — 컬럼 정의와 옵션은 그대로 두고 행만 0건으로 만든다. 같은 표 구조를 유지한 채 내용만 갈아엎기 전에 쓴다.
1351
+ *
1352
+ * Empty just the data — keep column defs and options, drop all rows to zero. Use it before reloading content into the same table shape.
1353
+ *
1354
+ * データだけをすべて空にします — 列定義とオプションはそのままに、行だけを 0 件にします。同じ表の構造を保ったまま中身だけを入れ替える前に使います。
1355
+ *
1356
+ * 只把数据全部清空 — 列定义与选项保持原样,只把行变成 0 件。想保持同样的表结构、只替换内容之前使用。
1357
+ */
473
1358
  clearData(): void;
474
1359
  /**
475
1360
  * 행 1건을 원하는 위치에 끼워 넣고 화면을 갱신한다. "추가" 버튼으로 빈 행이나 새 레코드를 넣을 때 쓰며,
476
1361
  * 일부 필드만 담은 부분 객체를 넘겨도 된다(나머지는 비어 있는 채로 삽입). 삽입 후 변경 추적에 "추가된 행"으로
477
1362
  * 잡히고, `before:insertRow` 트리거로 취소·검증할 수 있다.
478
- * / Insert one row at a chosen position and refresh the view. Use it for an "add" button that inserts a
1363
+ *
1364
+ * Insert one row at a chosen position and refresh the view. Use it for an "add" button that inserts a
479
1365
  * blank row or a new record; a partial object is fine (missing fields stay empty). The row is tracked as
480
1366
  * "added", and a `before:insertRow` trigger can cancel/validate it.
481
1367
  *
482
- * @param item - 행 데이터(부분 객체 허용) / Row data (partial object allowed)
483
- * @param position - 삽입 위치(기본 'last') / Insertion position (default 'last')
1368
+ * 行を 1 件、任意の位置に挿し込んで画面を更新します。「追加」ボタンで空行や新しいレコードを入れるときに使い、
1369
+ * 一部のフィールドだけを持つ部分オブジェクトを渡しても構いません(残りは空のまま挿入されます)。挿入後は変更追跡に
1370
+ * 「追加された行」として捕捉され、`before:insertRow` トリガーでキャンセル・検証できます。
1371
+ *
1372
+ * 把 1 行插入到任意位置并刷新画面。用「添加」按钮放入空行或新记录时使用,
1373
+ * 传入只含部分字段的部分对象也可以(其余字段以空值插入)。插入后会被变更追踪捕捉为「添加的行」,
1374
+ * 并可用 `before:insertRow` 触发器取消、校验。
1375
+ *
1376
+ * @param item - 행 데이터(부분 객체 허용)
1377
+ *
1378
+ * Row data (partial object allowed)
1379
+ *
1380
+ * 行データ(部分オブジェクト可)
1381
+ *
1382
+ * 行数据(允许部分对象)
1383
+ *
1384
+ * @param position - 삽입 위치(기본 'last')
1385
+ *
1386
+ * Insertion position (default 'last')
1387
+ *
1388
+ * 挿入位置(既定 'last')
1389
+ *
1390
+ * 插入位置(默认 'last')
1391
+ *
484
1392
  * @example
485
1393
  * grid.insertRow({ name: 'New' }, 'first');
486
1394
  */
487
1395
  insertRow(item: Partial<T>, position?: Position): void;
488
- /** 행(들)을 끝에 추가한다. / Append row(s) at the end. */
489
- pushRow(items: Partial<T> | Partial<T>[]): void;
490
- /** @deprecated 하위호환 alias → pushRow / Backward-compat alias → pushRow */
491
- appendRows(items: Partial<T> | Partial<T>[]): void;
492
- /** 행(들)을 맨 앞에 추가한다. / Prepend row(s) at the beginning. */
493
- unshiftRow(items: Partial<T> | Partial<T>[]): void;
494
- /** @deprecated 하위호환 alias → unshiftRow / Backward-compat alias → unshiftRow */
495
- prependRows(items: Partial<T> | Partial<T>[]): void;
496
1396
  /**
497
- * 행을 인덱스로 삭제하고 화면을 갱신한다. 하나만 지우려면 숫자를, 여러 개를 한 번에 지우려면 인덱스 배열을
498
- * 넘긴다(배열로 넘기면 배치로 한 번에 처리되어 개별 호출보다 빠르다). 삭제된 행은 변경 추적의 "삭제된 행"으로
499
- * 남아 `getRemovedRows()` 로 확인할 수 있다.
500
- * / Delete row(s) by index and refresh. Pass a number for one row, or an array to remove several at once
501
- * (an array is handled in a single batch, faster than one-by-one). Removed rows stay in change tracking
502
- * as "removed" and can be read via `getRemovedRows()`.
1397
+ * 행(들)을 끝에 추가한다.
1398
+ *
1399
+ * Append row(s) at the end.
1400
+ *
1401
+ * 行を末尾に追加します。
503
1402
  *
504
- * @param rowIndex - 삭제할 행 인덱스(단건 또는 배열) / Row index to delete (single or array)
1403
+ * 把行追加到末尾。
505
1404
  */
506
- deleteRow(rowIndex: number | number[]): void;
1405
+ pushRow(items: Partial<T> | Partial<T>[]): void;
507
1406
  /**
508
- * @deprecated no-op stub — id 기반 삭제는 미구현(본문 없음). 인덱스로 지우려면 `deleteRow(rowIndex)`
509
- * 를, id→인덱스 변환은 `getFlatRowModel()`/`getData()` 조회 후 `deleteRow` 를 사용.
510
- * / no-op stub — id-based deletion is not implemented (empty body). Use `deleteRow(rowIndex)`;
1407
+ * @deprecated 하위호환 alias → pushRow
1408
+ *
1409
+ * Backward-compat alias → pushRow
1410
+ *
1411
+ * 後方互換のエイリアス → pushRow
1412
+ *
1413
+ * 后方兼容的别名 → pushRow
1414
+ */
1415
+ appendRows(items: Partial<T> | Partial<T>[]): void;
1416
+ /**
1417
+ * 행(들)을 맨 앞에 추가한다.
1418
+ *
1419
+ * Prepend row(s) at the beginning.
1420
+ *
1421
+ * 行を先頭に追加します。
1422
+ *
1423
+ * 把行追加到最前。
1424
+ */
1425
+ unshiftRow(items: Partial<T> | Partial<T>[]): void;
1426
+ /**
1427
+ * @deprecated 하위호환 alias → unshiftRow
1428
+ *
1429
+ * Backward-compat alias → unshiftRow
1430
+ *
1431
+ * 後方互換のエイリアス → unshiftRow
1432
+ *
1433
+ * 后方兼容的别名 → unshiftRow
1434
+ */
1435
+ prependRows(items: Partial<T> | Partial<T>[]): void;
1436
+ /**
1437
+ * 행을 인덱스로 삭제하고 화면을 갱신한다. 하나만 지우려면 숫자를, 여러 개를 한 번에 지우려면 인덱스 배열을
1438
+ * 넘긴다(배열로 넘기면 배치로 한 번에 처리되어 개별 호출보다 빠르다). 삭제된 행은 변경 추적의 "삭제된 행"으로
1439
+ * 남아 `getRemovedRows()` 로 확인할 수 있다.
1440
+ *
1441
+ * Delete row(s) by index and refresh. Pass a number for one row, or an array to remove several at once
1442
+ * (an array is handled in a single batch, faster than one-by-one). Removed rows stay in change tracking
1443
+ * as "removed" and can be read via `getRemovedRows()`.
1444
+ *
1445
+ * 行をインデックスで削除して画面を更新します。1 件だけ消すなら数値を、複数をまとめて消すならインデックスの配列を
1446
+ * 渡します(配列で渡すとバッチで一括処理され、個別呼び出しより高速です)。削除された行は変更追跡の「削除された行」と
1447
+ * して残り、`getRemovedRows()` で確認できます。
1448
+ *
1449
+ * 按索引删除行并刷新画面。只删 1 件传数值,要一次删多件则传索引的数组
1450
+ * (以数组传入会按批一次性处理,比逐个调用更快)。被删除的行会作为变更追踪的「删除的行」保留,
1451
+ * 可用 `getRemovedRows()` 确认。
1452
+ *
1453
+ * @param rowIndex - 삭제할 행 인덱스(단건 또는 배열)
1454
+ *
1455
+ * Row index to delete (single or array)
1456
+ *
1457
+ * 削除する行のインデックス(単件または配列)
1458
+ *
1459
+ * 要删除的行索引(单件或数组)
1460
+ */
1461
+ deleteRow(rowIndex: number | number[]): void;
1462
+ /**
1463
+ * @deprecated no-op stub — id 기반 삭제는 미구현(본문 없음). 인덱스로 지우려면 `deleteRow(rowIndex)`
1464
+ * 를, id→인덱스 변환은 `getFlatRowModel()`/`getData()` 조회 후 `deleteRow` 를 사용.
1465
+ *
1466
+ * no-op stub — id-based deletion is not implemented (empty body). Use `deleteRow(rowIndex)`;
511
1467
  * resolve id→index via `getFlatRowModel()`/`getData()` first.
1468
+ *
1469
+ * no-op スタブ — id ベースの削除は未実装です(本体なし)。インデックスで消すには `deleteRow(rowIndex)` を、
1470
+ * id→インデックスの変換は `getFlatRowModel()`/`getData()` で引いたうえで `deleteRow` を使ってください。
1471
+ *
1472
+ * no-op 桩 — 基于 id 的删除未实现(无主体)。要按索引删除请用 `deleteRow(rowIndex)`;
1473
+ * id→索引的转换请先用 `getFlatRowModel()`/`getData()` 查出,再使用 `deleteRow`。
512
1474
  */
513
1475
  deleteById(_ids: string[]): void;
514
- /** 셀에 저장된 가공 전 원시 값을 그대로 읽는다(포맷·마스킹을 거치지 않은 실제 데이터). 계산·비교에 쓸 원값이 필요할 때 getDisplayValue 대신 쓴다. / Read the raw stored cell value (no formatting/masking) — use it instead of getDisplayValue when you need the real value for compute/compare. */
1476
+ /**
1477
+ * 셀에 저장된 가공 전 원시 값을 그대로 읽는다(포맷·마스킹을 거치지 않은 실제 데이터). 계산·비교에 쓸 원값이 필요할 때 getDisplayValue 대신 쓴다.
1478
+ *
1479
+ * Read the raw stored cell value (no formatting/masking) — use it instead of getDisplayValue when you need the real value for compute/compare.
1480
+ *
1481
+ * セルに保存された加工前の生の値をそのまま読み取ります(フォーマットやマスキングを経ていない実データ)。計算・比較に使う元の値が必要なときに getDisplayValue の代わりに使います。
1482
+ *
1483
+ * 原样读取单元格中保存的、加工前的原始值(未经过格式化或掩码的实际数据)。需要用于计算、比较的原值时,代替 getDisplayValue 使用。
1484
+ */
515
1485
  readCell(rowIndex: number, field: string): any;
516
1486
  /**
517
1487
  * 화면에 실제로 보이는 셀 텍스트를 돌려준다 — 원시 값에 displayFormatter 전략(숫자·날짜 포맷 등)을 적용한
518
1488
  * 결과다. 표에 표시되는 문자열 그대로를 복사·검색·툴팁에 쓰고 싶을 때 readCell(원값) 대신 쓴다.
519
- * / Return the cell text as actually displayed — the raw value with the displayFormatter strategy
1489
+ *
1490
+ * Return the cell text as actually displayed — the raw value with the displayFormatter strategy
520
1491
  * (number/date formatting, …) applied. Use it instead of readCell (raw) when you want the exact shown
521
1492
  * string for copy/search/tooltip.
522
1493
  *
523
- * @param rowIndex - 화면 기준 행 위치(flat index) / On-screen row position (flat index)
524
- * @param field - 컬럼 field / Column field
525
- * @returns 표시용 문자열 / The display string
1494
+ * 画面に実際に見えているセルのテキストを返します — 生の値に displayFormatter 戦略(数値・日付のフォーマットなど)を
1495
+ * 適用した結果です。表に表示される文字列そのものをコピー・検索・ツールチップに使いたいときに、readCell(生の値)の
1496
+ * 代わりに使います。
1497
+ *
1498
+ * 返回画面上实际可见的单元格文本 — 是对原始值应用 displayFormatter 策略(数值、日期格式化等)后的结果。
1499
+ * 想把表格中显示的字符串原样用于复制、搜索、提示框时,代替 readCell(原值)使用。
1500
+ *
1501
+ * @param rowIndex - 화면 기준 행 위치(flat index)
1502
+ *
1503
+ * On-screen row position (flat index)
1504
+ *
1505
+ * 画面基準の行位置(flat index)
1506
+ *
1507
+ * 以画面为准的行位置(flat index)
1508
+ *
1509
+ * @param field - 컬럼 field
1510
+ *
1511
+ * Column field
1512
+ *
1513
+ * 列の field
1514
+ *
1515
+ * 列的 field
1516
+ *
1517
+ * @returns 표시용 문자열
1518
+ *
1519
+ * The display string
1520
+ *
1521
+ * 表示用の文字列
1522
+ *
1523
+ * 显示用的字符串
526
1524
  */
527
1525
  getDisplayValue(rowIndex: number, field: string): string;
528
1526
  /**
529
1527
  * 셀 하나의 값을 코드로 바꾼다(사용자 편집이 아니라 프로그램 갱신 경로). 값을 쓰면서 변경 추적에 기록하고,
530
1528
  * 이 셀을 참조하는 수식들을 다시 계산하도록 표시한 뒤 화면을 다시 그린다. 낱개로 여러 셀을 바꿀 때는 렌더가
531
1529
  * 매번 일어나니, 대량이면 `writeCells()` 나 `beginBatch()`/`endBatch()` 로 묶는 편이 빠르다.
532
- * / Change one cell's value from code (the programmatic path, not user editing). It records the change in
1530
+ *
1531
+ * Change one cell's value from code (the programmatic path, not user editing). It records the change in
533
1532
  * change tracking, marks formulas that reference this cell for recompute, then re-renders. For many cells,
534
1533
  * prefer `writeCells()` or `beginBatch()`/`endBatch()` since each call re-renders.
535
1534
  *
536
- * @param rowIndex - 화면 기준 행 위치(flat index) / On-screen row position (flat index)
537
- * @param field - 컬럼 field / Column field
538
- * @param value - 기록할 값 / Value to write
1535
+ * セル 1 つの値をコードから変えます(ユーザー編集ではなくプログラムからの更新経路)。値を書きながら変更追跡に記録し、
1536
+ * このセルを参照する数式を再計算対象として印を付けたうえで、画面を描画し直します。ばらばらに複数のセルを変えると
1537
+ * そのつどレンダーが走るため、大量の場合は `writeCells()` や `beginBatch()`/`endBatch()` でまとめたほうが高速です。
1538
+ *
1539
+ * 用代码改变单个单元格的值(不是用户编辑,而是程序的更新路径)。写值的同时记录到变更追踪,
1540
+ * 并把引用该单元格的公式标记为重算对象,然后重新绘制画面。零散地改多个单元格会每次都触发渲染,
1541
+ * 数量大时用 `writeCells()` 或 `beginBatch()`/`endBatch()` 打包更快。
1542
+ *
1543
+ * @param rowIndex - 화면 기준 행 위치(flat index)
1544
+ *
1545
+ * On-screen row position (flat index)
1546
+ *
1547
+ * 画面基準の行位置(flat index)
1548
+ *
1549
+ * 以画面为准的行位置(flat index)
1550
+ *
1551
+ * @param field - 컬럼 field
1552
+ *
1553
+ * Column field
1554
+ *
1555
+ * 列の field
1556
+ *
1557
+ * 列的 field
1558
+ *
1559
+ * @param value - 기록할 값
1560
+ *
1561
+ * Value to write
1562
+ *
1563
+ * 書き込む値
1564
+ *
1565
+ * 要写入的值
539
1566
  */
540
1567
  writeCell(rowIndex: number, field: string, value: any): void;
541
- /** 지정 인덱스의 행 객체를 돌려준다(단건 조회용). / Return the row object at the given index (single-row lookup). */
1568
+ /**
1569
+ * 지정 인덱스의 행 객체를 돌려준다(단건 조회용).
1570
+ *
1571
+ * Return the row object at the given index (single-row lookup).
1572
+ *
1573
+ * 指定インデックスの行オブジェクトを返します(単件照会用)。
1574
+ *
1575
+ * 返回指定索引的行对象(单件查询用)。
1576
+ */
542
1577
  getRowAt(rowIndex: number): T;
543
1578
  /**
544
1579
  * 화면상의 행 위치(flat/visual index)와 실제 데이터 행을 서로 변환해 주는 리졸버를 돌려준다. 그룹 머리글·
545
1580
  * 트리 자식·상세 패널 같은 의사(pseudo) 행이 섞여 index 와 데이터가 어긋날 때, "이 index 가 진짜 데이터 행인가,
546
1581
  * 몇 번 rowId 인가"를 물어보는 단일 창구다. 범위 선택+채우기·수식·차트 기능이 좌표를 해석할 때 모두 이 모델을 거친다.
547
- * / Return the resolver that maps between an on-screen row position (flat/visual index) and the actual
1582
+ *
1583
+ * Return the resolver that maps between an on-screen row position (flat/visual index) and the actual
548
1584
  * data row. When pseudo rows (group headers, tree children, detail panels) are interleaved and the
549
1585
  * index no longer lines up with the data, this is the single place to ask "is this index a real data
550
1586
  * row, and which rowId is it?". Range-fill, formulas, and charts all resolve coordinates through it.
551
1587
  *
552
- * @returns flat/visual index ↔ data 리졸버 / The flat/visual index ↔ data resolver
1588
+ * 画面上の行位置(flat/visual index)と実際のデータ行を相互に変換するリゾルバを返します。グループ見出し・ツリーの
1589
+ * 子・詳細パネルといった擬似(pseudo)行が混ざって index とデータがずれるとき、「この index は本当のデータ行なのか、
1590
+ * どの rowId なのか」を尋ねる唯一の窓口です。範囲選択+塗りつぶし・数式・チャートの各機能は、座標を解釈する際に
1591
+ * すべてこのモデルを経由します。
1592
+ *
1593
+ * 返回在画面上的行位置(flat/visual index)与实际数据行之间相互转换的解析器。当分组标题、树的子项、
1594
+ * 明细面板这类伪(pseudo)行混入,index 与数据对不上时,它是询问「这个 index 是不是真正的数据行,是哪个 rowId」
1595
+ * 的唯一窗口。范围选择+填充、公式、图表各功能在解释坐标时,都要经由这个模型。
1596
+ *
1597
+ * @returns flat/visual index ↔ data 리졸버
1598
+ *
1599
+ * The flat/visual index ↔ data resolver
1600
+ *
1601
+ * flat/visual index ↔ data のリゾルバ
1602
+ *
1603
+ * flat/visual index ↔ data 的解析器
553
1604
  */
554
1605
  getFlatRowModel(): FlatRowModel;
555
- /** 배치 쓰기를 연다. 이 뒤로 이어지는 writeCell 들은 그때그때 다시 그리지 않고 모아 두었다가 endBatch 에서 한 번에 반영된다. 수많은 셀을 갱신할 때 endBatch 와 짝지어 감싼다. / Open a write batch — subsequent writeCell calls are collected instead of re-rendering each time, and flushed together at endBatch. Wrap bulk updates with a matching endBatch. */
1606
+ /**
1607
+ * 배치 쓰기를 연다. 이 뒤로 이어지는 writeCell 들은 그때그때 다시 그리지 않고 모아 두었다가 endBatch 에서 한 번에 반영된다. 수많은 셀을 갱신할 때 endBatch 와 짝지어 감싼다.
1608
+ *
1609
+ * Open a write batch — subsequent writeCell calls are collected instead of re-rendering each time, and flushed together at endBatch. Wrap bulk updates with a matching endBatch.
1610
+ *
1611
+ * バッチ書き込みを開きます。これ以降に続く writeCell は、そのつど描画し直さずに溜め込まれ、endBatch でまとめて反映されます。多数のセルを更新するときは endBatch と対にして囲みます。
1612
+ *
1613
+ * 打开批量写入。此后接续的 writeCell 不会每次重绘,而是先攒起来,在 endBatch 一次性反映。更新大量单元格时,与 endBatch 成对包住。
1614
+ */
556
1615
  beginBatch(): void;
557
- /** 배치를 닫고 모아 둔 쓰기를 한 번에 반영한다 — 그 사이 변경이 있었으면 렌더 1회 + dataChange 이벤트 1회만 발생한다. beginBatch 와 반드시 짝을 맞춘다. / Close the batch and flush collected writes at once — if anything changed, exactly one render + one dataChange event fires. Always pair it with beginBatch. */
1616
+ /**
1617
+ * 배치를 닫고 모아 둔 쓰기를 한 번에 반영한다 — 그 사이 변경이 있었으면 렌더 1회 + dataChange 이벤트 1회만 발생한다. beginBatch 와 반드시 짝을 맞춘다.
1618
+ *
1619
+ * Close the batch and flush collected writes at once — if anything changed, exactly one render + one dataChange event fires. Always pair it with beginBatch.
1620
+ *
1621
+ * バッチを閉じ、溜め込んだ書き込みを一度に反映します — その間に変更があれば、レンダー 1 回 + dataChange イベント 1 回だけが発生します。必ず beginBatch と対にしてください。
1622
+ *
1623
+ * 关闭批量并把攒下的写入一次性反映 — 其间若有变更,只发生 1 次渲染 + 1 次 dataChange 事件。务必与 beginBatch 成对使用。
1624
+ */
558
1625
  endBatch(): void;
559
1626
  /**
560
1627
  * 셀에 스프레드시트 스타일 수식을 건다("=A1+B2" 형태). 셀 값을 고정 숫자가 아니라 다른 셀에서
561
1628
  * 계산되게 만들고 싶을 때 쓴다 — 참조한 셀이 바뀌면 이 셀도 자동으로 다시 계산되고, 순환 참조·에러는
562
1629
  * `getCellError()` 로 표면화된다.
563
- * / Attach a spreadsheet-style formula to a cell (e.g. "=A1+B2"). Use it when a cell's value should
1630
+ *
1631
+ * Attach a spreadsheet-style formula to a cell (e.g. "=A1+B2"). Use it when a cell's value should
564
1632
  * be computed from other cells rather than a fixed number — the cell recomputes automatically when
565
1633
  * a referenced cell changes, and cycles/errors surface via `getCellError()`.
566
1634
  *
567
- * @param rowIndex - 화면 기준 행 위치(flat index) / On-screen row position (flat index)
568
- * @param field - 컬럼 field / Column field
569
- * @param formula - '=' 로 시작하는 수식 원문 / Formula source starting with '='
1635
+ * セルにスプレッドシート形式の数式を掛けます(「=A1+B2」の形)。セルの値を固定の数値ではなく、ほかのセルから
1636
+ * 計算させたいときに使います — 参照したセルが変われば、このセルも自動的に再計算され、循環参照やエラーは
1637
+ * `getCellError()` で表面化します。
1638
+ *
1639
+ * 给单元格挂上电子表格式的公式(「=A1+B2」的形式)。想让单元格的值不是固定数值、而是由其他单元格
1640
+ * 计算得出时使用 — 被引用的单元格一变,这个单元格也会自动重算,循环引用与错误则通过 `getCellError()` 表面化。
1641
+ *
1642
+ * @param rowIndex - 화면 기준 행 위치(flat index)
1643
+ *
1644
+ * On-screen row position (flat index)
1645
+ *
1646
+ * 画面基準の行位置(flat index)
1647
+ *
1648
+ * 以画面为准的行位置(flat index)
1649
+ *
1650
+ * @param field - 컬럼 field
1651
+ *
1652
+ * Column field
1653
+ *
1654
+ * 列の field
1655
+ *
1656
+ * 列的 field
1657
+ *
1658
+ * @param formula - '=' 로 시작하는 수식 원문
1659
+ *
1660
+ * Formula source starting with '='
1661
+ *
1662
+ * '=' で始まる数式の原文
1663
+ *
1664
+ * 以 '=' 开头的公式原文
1665
+ *
570
1666
  * @example
571
1667
  * grid.setCellFormula(2, 'total', '=A1+B1');
572
1668
  */
573
1669
  setCellFormula(rowIndex: number, field: string, formula: string): void;
574
- /** 셀 수식 원문(없으면 null). / Formula source of the cell (null when absent). */
1670
+ /**
1671
+ * 셀 수식 원문(없으면 null).
1672
+ *
1673
+ * Formula source of the cell (null when absent).
1674
+ *
1675
+ * セル数式の原文(なければ null)。
1676
+ *
1677
+ * 单元格公式的原文(没有则为 null)。
1678
+ */
575
1679
  getCellFormula(rowIndex: number, field: string): string | null;
576
- /** 셀에 수식이 있는지. / Whether the cell has a formula. */
1680
+ /**
1681
+ * 셀에 수식이 있는지.
1682
+ *
1683
+ * Whether the cell has a formula.
1684
+ *
1685
+ * セルに数式があるかどうか。
1686
+ *
1687
+ * 单元格是否有公式。
1688
+ */
577
1689
  hasCellFormula(rowIndex: number, field: string): boolean;
578
- /** 수식 제거(마지막 계산값은 유지). / Remove the formula (last computed value kept). */
1690
+ /**
1691
+ * 수식 제거(마지막 계산값은 유지).
1692
+ *
1693
+ * Remove the formula (last computed value kept).
1694
+ *
1695
+ * 数式の削除(最後の計算値は維持)。
1696
+ *
1697
+ * 删除公式(最后的计算值保留)。
1698
+ */
579
1699
  clearCellFormula(rowIndex: number, field: string): void;
580
- /** 셀 수식 에러 코드(없으면 null). / Formula error code of the cell (null when none). */
1700
+ /**
1701
+ * 셀 수식 에러 코드(없으면 null).
1702
+ *
1703
+ * Formula error code of the cell (null when none).
1704
+ *
1705
+ * セル数式のエラーコード(なければ null)。
1706
+ *
1707
+ * 单元格公式的错误码(没有则为 null)。
1708
+ */
581
1709
  getCellError(rowIndex: number, field: string): FormulaErrorCode | null;
582
- /** 디버깅용 — 이 셀을 참조하는(종속) 셀들. / Debugging — cells that depend on this cell. */
1710
+ /**
1711
+ * 디버깅용 — 이 셀을 참조하는(종속) 셀들.
1712
+ *
1713
+ * Debugging — cells that depend on this cell.
1714
+ *
1715
+ * デバッグ用 — このセルを参照する(従属)セル群。
1716
+ *
1717
+ * 调试用 — 引用该单元格的(从属)单元格。
1718
+ */
583
1719
  getDependents(rowIndex: number, field: string): Array<{
584
1720
  rowIndex: number;
585
1721
  field: string;
586
1722
  }>;
587
- /** 디버깅용 — 이 셀이 참조하는(선행) 셀들. / Debugging — cells this cell references (precedents). */
1723
+ /**
1724
+ * 디버깅용 — 이 셀이 참조하는(선행) 셀들.
1725
+ *
1726
+ * Debugging — cells this cell references (precedents).
1727
+ *
1728
+ * デバッグ用 — このセルが参照する(先行)セル群。
1729
+ *
1730
+ * 调试用 — 该单元格引用的(先行)单元格。
1731
+ */
588
1732
  getPrecedents(rowIndex: number, field: string): Array<{
589
1733
  rowIndex: number;
590
1734
  field: string;
591
1735
  }>;
592
- /** 전체 수식 위상 재계산. / Recalculate all formulas in topological order. */
1736
+ /**
1737
+ * 전체 수식 위상 재계산.
1738
+ *
1739
+ * Recalculate all formulas in topological order.
1740
+ *
1741
+ * 全数式のトポロジカル再計算。
1742
+ *
1743
+ * 全部公式的拓扑重算。
1744
+ */
593
1745
  recalculate(): void;
594
- /** 단일 셀 + 종속 폐포만 재계산. / Recalculate one cell plus its dependent closure. */
1746
+ /**
1747
+ * 단일 셀 + 종속 폐포만 재계산.
1748
+ *
1749
+ * Recalculate one cell plus its dependent closure.
1750
+ *
1751
+ * 単一セル + その従属閉包のみを再計算。
1752
+ *
1753
+ * 只重算单个单元格 + 其从属闭包。
1754
+ */
595
1755
  recalculateCell(rowIndex: number, field: string): void;
596
1756
  /**
597
1757
  * 원본 셀 수식을 dRow/dCol 만큼 옮겨 새 위치에 맞게 상대 참조를 조정한 수식 원문을 만든다. 범위 선택+채우기
598
1758
  * 로 수식을 아래·옆으로 끌어 복사할 때, 절대 참조(`$` 고정)는 그대로 두고 상대 참조만 이동량만큼 밀어 주는
599
1759
  * 저수준 도우미다(엑셀에서 수식을 드래그 복사하면 참조가 따라 움직이는 것과 같은 규칙).
600
- * / Produce a formula source with relative references shifted by dRow/dCol so it fits a new location.
1760
+ *
1761
+ * Produce a formula source with relative references shifted by dRow/dCol so it fits a new location.
601
1762
  * A low-level helper used when range-fill drags a formula down/across: absolute (`$`-locked) refs stay
602
1763
  * put while relative refs move by the offset — the same rule as drag-copying a formula in a spreadsheet.
603
1764
  *
604
- * @param srcRowId - 원본 셀의 rowId / rowId of the source cell
605
- * @param srcField - 원본 셀의 field / field of the source cell
606
- * @param dRow - 행 오프셋 / Row offset
607
- * @param dCol - 열 오프셋 / Column offset
608
- * @returns 이동 반영된 새 수식 원문 / New formula source with the offset applied
1765
+ * 元のセル数式を dRow/dCol の分だけずらし、新しい位置に合わせて相対参照を調整した数式の原文を作ります。範囲選択+
1766
+ * 塗りつぶしで数式を下・横へ引いてコピーするとき、絶対参照(`$` で固定)はそのままに、相対参照だけを移動量の分だけ
1767
+ * ずらす低レベルのヘルパーです(スプレッドシートで数式をドラッグコピーすると参照が付いて動くのと同じ規則)。
1768
+ *
1769
+ * 把原单元格公式按 dRow/dCol 平移,生成一份按新位置调整了相对引用的公式原文。用范围选择+填充把公式
1770
+ * 向下、向旁拖拽复制时,绝对引用(用 `$` 固定)保持不动,只把相对引用按位移量推移的低层辅助函数
1771
+ * (与在 Excel 中拖拽复制公式时引用会跟着移动的规则相同)。
1772
+ *
1773
+ * @param srcRowId - 원본 셀의 rowId
1774
+ *
1775
+ * rowId of the source cell
1776
+ *
1777
+ * 元のセルの rowId
1778
+ *
1779
+ * 原单元格的 rowId
1780
+ *
1781
+ * @param srcField - 원본 셀의 field
1782
+ *
1783
+ * field of the source cell
1784
+ *
1785
+ * 元のセルの field
1786
+ *
1787
+ * 原单元格的 field
1788
+ *
1789
+ * @param dRow - 행 오프셋
1790
+ *
1791
+ * Row offset
1792
+ *
1793
+ * 行のオフセット
1794
+ *
1795
+ * 行的偏移量
1796
+ *
1797
+ * @param dCol - 열 오프셋
1798
+ *
1799
+ * Column offset
1800
+ *
1801
+ * 列のオフセット
1802
+ *
1803
+ * 列的偏移量
1804
+ *
1805
+ * @returns 이동 반영된 새 수식 원문
1806
+ *
1807
+ * New formula source with the offset applied
1808
+ *
1809
+ * 移動が反映された新しい数式の原文
1810
+ *
1811
+ * 反映了平移的新公式原文
609
1812
  */
610
1813
  offsetFormula(srcRowId: string, srcField: string, dRow: number, dCol: number): string;
611
1814
  /**
@@ -614,14 +1817,40 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
614
1817
  * index)이며, 대상이 실제 데이터 행이 아니라 그룹 머리글·트리·상세 같은 의사(pseudo) 행이면 데이터 훼손을
615
1818
  * 막기 위해 그 셀은 조용히 건너뛴다. 건너뛴 셀 수를 돌려주고, 1건이라도 있으면 스크린리더 안내와
616
1819
  * 'writeCellsSkip' 이벤트로 알린다.
617
- * / Write many cells at once. They are wrapped in one batch, so render/events fire once at the end
1820
+ *
1821
+ * Write many cells at once. They are wrapped in one batch, so render/events fire once at the end
618
1822
  * instead of per cell — much faster than looping single `writeCell` calls for hundreds of cells. Each
619
1823
  * rowIndex is an on-screen position (flat index); if a target is not a real data row but a pseudo row
620
1824
  * (group header, tree, detail), that cell is skipped to avoid corrupting data. Returns the number of
621
1825
  * skipped cells and, when non-zero, surfaces it via a screen-reader announce + a 'writeCellsSkip' event.
622
1826
  *
623
- * @param patches - 쓰기 목록 / List of writes
624
- * @returns 건너뛴 셀 수 / Number of skipped cells
1827
+ * 複数のセルを一度に書き込みます。内部でバッチにまとめて処理するため、レンダーやイベントがセルごとに走らず最後に
1828
+ * 1 回だけ起こり、数百セルを更新するときに `writeCell` を 1 件ずつ繰り返すよりはるかに高速です。各 rowIndex は
1829
+ * 画面基準の位置(flat index)であり、対象が実際のデータ行ではなくグループ見出し・ツリー・詳細といった擬似(pseudo)
1830
+ * 行の場合は、データの破損を防ぐためそのセルを黙ってスキップします。スキップしたセル数を返し、1 件でもあれば
1831
+ * スクリーンリーダーへの通知と 'writeCellsSkip' イベントで知らせます。
1832
+ *
1833
+ * 一次写入多个单元格。内部打包成批处理,因此渲染与事件不会每个单元格都触发,而是最后只发生 1 次,
1834
+ * 更新数百个单元格时比逐个重复 `writeCell` 快得多。各 rowIndex 是以画面为准的位置(flat index),
1835
+ * 若目标不是实际的数据行,而是分组标题、树、明细这类伪(pseudo)行,为防止数据损坏会静默跳过该单元格。
1836
+ * 返回跳过的单元格数,只要有 1 件就通过屏幕阅读器通知和 'writeCellsSkip' 事件告知。
1837
+ *
1838
+ * @param patches - 쓰기 목록
1839
+ *
1840
+ * List of writes
1841
+ *
1842
+ * 書き込みの一覧
1843
+ *
1844
+ * 写入的列表
1845
+ *
1846
+ * @returns 건너뛴 셀 수
1847
+ *
1848
+ * Number of skipped cells
1849
+ *
1850
+ * スキップしたセル数
1851
+ *
1852
+ * 跳过的单元格数
1853
+ *
625
1854
  * @example
626
1855
  * const skipped = grid.writeCells([
627
1856
  * { rowIndex: 0, field: 'qty', value: 10 },
@@ -633,41 +1862,140 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
633
1862
  field: string;
634
1863
  value: any;
635
1864
  }>): number;
636
- /** 사용자가 드래그로 선택한 셀 사각형(범위)들을 정규화해 돌려준다. 선택이 없으면 빈 배열. 현재 버전은 한 번에 하나의 범위만 다루므로 길이는 최대 1이다. / Return the user's drag-selected cell rectangles, normalized; empty when nothing is selected. This version handles one range at a time, so length is at most 1. */
1865
+ /**
1866
+ * 사용자가 드래그로 선택한 셀 사각형(범위)들을 정규화해 돌려준다. 선택이 없으면 빈 배열. 현재 버전은 한 번에 하나의 범위만 다루므로 길이는 최대 1이다.
1867
+ *
1868
+ * Return the user's drag-selected cell rectangles, normalized; empty when nothing is selected. This version handles one range at a time, so length is at most 1.
1869
+ *
1870
+ * ユーザーがドラッグで選択したセルの矩形(範囲)を正規化して返します。選択がなければ空配列です。現在のバージョンは一度に 1 つの範囲しか扱わないため、長さは最大 1 です。
1871
+ *
1872
+ * 把用户拖拽选中的单元格矩形(范围)规范化后返回。没有选择则为空数组。当前版本一次只处理 1 个范围,因此长度最大为 1。
1873
+ */
637
1874
  getRangeSelection(): CellRange[];
638
- /** 지금 활성인 선택 범위 하나를 바로 꺼내는 지름길(선택이 없으면 null). 선택 여부만 확인하거나 그 범위로 값을 읽을 때 쓴다. / Shortcut to the single active selection range (null when none) — handy to check selection or read values from it. */
1875
+ /**
1876
+ * 지금 활성인 선택 범위 하나를 바로 꺼내는 지름길(선택이 없으면 null). 선택 여부만 확인하거나 그 범위로 값을 읽을 때 쓴다.
1877
+ *
1878
+ * Shortcut to the single active selection range (null when none) — handy to check selection or read values from it.
1879
+ *
1880
+ * いま有効な選択範囲を 1 つだけ直接取り出す近道(選択がなければ null)。選択の有無を確認したり、その範囲から値を読んだりするときに使います。
1881
+ *
1882
+ * 直接取出当前有效的 1 个选择范围的近道(没有选择则为 null)。用于确认是否有选择,或从该范围读取值。
1883
+ */
639
1884
  getActiveRange(): CellRange | null;
640
- /** 마우스 드래그 없이 코드로 셀 범위를 선택 상태로 만든다. 검색 결과나 계산으로 특정 영역을 하이라이트하고 싶을 때 쓴다. / Select a cell range from code (no mouse drag) — use it to highlight a region from a search result or computation. */
1885
+ /**
1886
+ * 마우스 드래그 없이 코드로 셀 범위를 선택 상태로 만든다. 검색 결과나 계산으로 특정 영역을 하이라이트하고 싶을 때 쓴다.
1887
+ *
1888
+ * Select a cell range from code (no mouse drag) — use it to highlight a region from a search result or computation.
1889
+ *
1890
+ * マウスのドラッグなしに、コードからセル範囲を選択状態にします。検索結果や計算によって特定の領域をハイライトしたいときに使います。
1891
+ *
1892
+ * 不用鼠标拖拽,而从代码把单元格范围置为选中状态。想根据搜索结果或计算高亮特定区域时使用。
1893
+ */
641
1894
  setRangeSelection(range: CellRange | CellRange[]): void;
642
- /** 현재 범위 선택을 모두 해제해 하이라이트를 지운다. / Clear the range selection, removing the highlight. */
1895
+ /**
1896
+ * 현재 범위 선택을 모두 해제해 하이라이트를 지운다.
1897
+ *
1898
+ * Clear the range selection, removing the highlight.
1899
+ *
1900
+ * 現在の範囲選択をすべて解除し、ハイライトを消します。
1901
+ *
1902
+ * 解除当前的全部范围选择,清除高亮。
1903
+ */
643
1904
  clearRangeSelection(): void;
644
- /** 활성 범위 안의 셀 값들을 행×열 2차원 배열로 추출한다. 선택 영역을 복사하거나 외부로 넘길 때 쓴다. / Extract the active range's cell values as a row×column 2D array — for copying or exporting the selection. */
1905
+ /**
1906
+ * 활성 범위 안의 셀 값들을 행×열 2차원 배열로 추출한다. 선택 영역을 복사하거나 외부로 넘길 때 쓴다.
1907
+ *
1908
+ * Extract the active range's cell values as a row×column 2D array — for copying or exporting the selection.
1909
+ *
1910
+ * 有効な範囲内のセル値を、行×列の 2 次元配列として取り出します。選択領域をコピーしたり外部へ渡したりするときに使います。
1911
+ *
1912
+ * 把有效范围内的单元格值,以行×列的二维数组取出。用于复制选择区域或传给外部。
1913
+ */
645
1914
  getRangeValues(): any[][];
646
- /** 활성 범위의 숫자 셀들만 모아 합계·평균 등 요약값을 계산한다(정밀 십진 연산 기반, 선택 없으면 null). 상태바에 "선택 합계"를 띄우는 용도. / Compute sum/avg… over just the numeric cells in the active range (exact-decimal math; null when no selection) — e.g. to show a "sum of selection" in a status bar. */
1915
+ /**
1916
+ * 활성 범위의 숫자 셀들만 모아 합계·평균 등 요약값을 계산한다(정밀 십진 연산 기반, 선택 없으면 null). 상태바에 "선택 합계"를 띄우는 용도.
1917
+ *
1918
+ * Compute sum/avg… over just the numeric cells in the active range (exact-decimal math; null when no selection) — e.g. to show a "sum of selection" in a status bar.
1919
+ *
1920
+ * 有効な範囲の数値セルだけを集めて、合計・平均などの要約値を計算します(高精度な十進演算に基づき、選択がなければ null)。ステータスバーに「選択範囲の合計」を出す用途です。
1921
+ *
1922
+ * 只收集有效范围内的数值单元格,计算合计、平均等汇总值(基于高精度十进制运算,没有选择则为 null)。用途是在状态栏显示「选择范围的合计」。
1923
+ */
647
1924
  getRangeStats(): RangeStats | null;
648
1925
  /**
649
1926
  * 원본 범위의 값을 대상 범위로 채워 넣는다 — 엑셀에서 채우기 핸들을 아래·옆으로 끌어 값을 복사하거나
650
1927
  * 연속값을 만드는 동작을 프로그램으로 실행하는 API다. 채우는 방향(가로/세로)은 두 범위의 상대 위치로
651
1928
  * 자동 추론하며, 내부적으로 배치로 묶어 한 번에 반영한다.
652
- * / Fill the target range from the source range — the programmatic form of dragging Excel's fill
1929
+ *
1930
+ * Fill the target range from the source range — the programmatic form of dragging Excel's fill
653
1931
  * handle down/across to copy values or extend a series. The direction (horizontal/vertical) is
654
1932
  * inferred from the two ranges' relative position, and the writes are applied in one batch.
655
1933
  *
656
- * @param source - 원본 범위 / Source range
657
- * @param target - 대상 범위 / Target range
658
- * @param mode - 'copy'(같은 값 복사, 기본) 또는 'series'(연속값 생성) / 'copy' (repeat values, default) or 'series' (extend a sequence)
1934
+ * 元の範囲の値を対象範囲へ流し込みます — スプレッドシートで塗りつぶしハンドルを下・横へ引いて値をコピーしたり、
1935
+ * 連続値を作ったりする動作をプログラムから実行する API です。塗りつぶす方向(横/縦)は 2 つの範囲の相対位置から
1936
+ * 自動的に推論し、内部ではバッチにまとめて一度に反映します。
1937
+ *
1938
+ * 把源范围的值灌入目标范围 — 是把在 Excel 中把填充手柄向下、向旁拖拽以复制值或生成连续值的动作,
1939
+ * 用程序执行的 API。填充的方向(横/纵)由两个范围的相对位置自动推断,内部打包成批一次性反映。
1940
+ *
1941
+ * @param source - 원본 범위
1942
+ *
1943
+ * Source range
1944
+ *
1945
+ * 元の範囲
1946
+ *
1947
+ * 源范围
1948
+ *
1949
+ * @param target - 대상 범위
1950
+ *
1951
+ * Target range
1952
+ *
1953
+ * 対象範囲
1954
+ *
1955
+ * 目标范围
1956
+ *
1957
+ * @param mode - 'copy'(같은 값 복사, 기본) 또는 'series'(연속값 생성)
1958
+ *
1959
+ * 'copy' (repeat values, default) or 'series' (extend a sequence)
1960
+ *
1961
+ * 'copy'(同じ値をコピー、既定)または 'series'(連続値を生成)
1962
+ *
1963
+ * 'copy'(复制相同的值,默认)或 'series'(生成连续值)
659
1964
  */
660
1965
  fillRange(source: CellRange, target: CellRange, mode?: 'copy' | 'series'): void;
661
1966
  /**
662
1967
  * 그리드에 들어 있는 데이터를 그대로 원천으로 삼아 차트를 만든다. 별도로 데이터를 넘길 필요 없이
663
1968
  * "어떤 컬럼을(source/series) 어떤 모양으로(type) 그릴지"만 지정하면 된다. `live: true` 로 만들면
664
1969
  * 그리드 데이터가 바뀔 때 차트도 자동으로 다시 그려져, 표와 그래프가 항상 같은 값을 가리킨다.
665
- * / Create a chart that uses the grid's own data as its source. You don't pass data separately — just
1970
+ *
1971
+ * Create a chart that uses the grid's own data as its source. You don't pass data separately — just
666
1972
  * declare which columns to draw (source/series) and how (type). With `live: true` the chart re-renders
667
1973
  * whenever the grid data changes, so table and chart always show the same numbers.
668
1974
  *
669
- * @param config - 차트 구성(소스·타입·배치 등) / Chart config (source, type, placement, …)
670
- * @returns 생성된 차트 인스턴스 / The created chart instance
1975
+ * グリッドに入っているデータをそのまま源としてチャートを作ります。データを別途渡す必要はなく、「どの列を
1976
+ * (source/series)どの形で(type)描くか」だけを指定します。`live: true` で作ると、グリッドのデータが変わったとき
1977
+ * チャートも自動的に描画し直され、表とグラフが常に同じ値を指します。
1978
+ *
1979
+ * 把表格中的数据直接当作源来制作图表。无需另外传入数据,只要指定「把哪些列(source/series)
1980
+ * 以什么形状(type)绘制」即可。用 `live: true` 创建时,表格数据一变,图表也会自动重新绘制,
1981
+ * 使表与图始终指向相同的值。
1982
+ *
1983
+ * @param config - 차트 구성(소스·타입·배치 등)
1984
+ *
1985
+ * Chart config (source, type, placement, …)
1986
+ *
1987
+ * チャートの構成(ソース・タイプ・配置など)
1988
+ *
1989
+ * 图表的构成(源、类型、放置等)
1990
+ *
1991
+ * @returns 생성된 차트 인스턴스
1992
+ *
1993
+ * The created chart instance
1994
+ *
1995
+ * 生成されたチャートインスタンス
1996
+ *
1997
+ * 生成的图表实例
1998
+ *
671
1999
  * @example
672
2000
  * const chart = grid.createChart({
673
2001
  * type: 'bar',
@@ -676,21 +2004,69 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
676
2004
  * });
677
2005
  */
678
2006
  createChart(config: ChartConfig): ChartInstance;
679
- /** 이 그리드가 만들어 아직 살아 있는 차트 인스턴스들을 돌려준다(일괄 갱신·조회용). / Return the still-alive chart instances this grid created — for bulk refresh/inspection. */
2007
+ /**
2008
+ * 이 그리드가 만들어 아직 살아 있는 차트 인스턴스들을 돌려준다(일괄 갱신·조회용).
2009
+ *
2010
+ * Return the still-alive chart instances this grid created — for bulk refresh/inspection.
2011
+ *
2012
+ * このグリッドが作り、まだ生きているチャートインスタンスを返します(一括更新・照会用)。
2013
+ *
2014
+ * 返回这个表格创建且仍然存活的图表实例(用于批量更新、查询)。
2015
+ */
680
2016
  getCharts(): ChartInstance[];
681
- /** 이 그리드가 만든 모든 차트를 파괴한다. 데이터 변경 구독까지 함께 끊어 메모리 누수를 막으므로, 차트를 정리할 때 반드시 호출한다. / Destroy every chart this grid made, cutting their data-change subscriptions too to prevent leaks — call it when tearing charts down. */
2017
+ /**
2018
+ * 이 그리드가 만든 모든 차트를 파괴한다. 데이터 변경 구독까지 함께 끊어 메모리 누수를 막으므로, 차트를 정리할 때 반드시 호출한다.
2019
+ *
2020
+ * Destroy every chart this grid made, cutting their data-change subscriptions too to prevent leaks — call it when tearing charts down.
2021
+ *
2022
+ * このグリッドが作ったすべてのチャートを破棄します。データ変更の購読も併せて切ってメモリリークを防ぐため、チャートを片付けるときは必ず呼び出してください。
2023
+ *
2024
+ * 销毁这个表格创建的所有图表。会一并切断数据变更的订阅以防止内存泄漏,因此清理图表时务必调用。
2025
+ */
682
2026
  destroyCharts(): void;
683
- /** 마지막 저장 이후 무엇이 바뀌었는지를 추가·수정·삭제 세 묶음으로 돌려준다. "변경분만 서버로 보내기"처럼 저장 시 델타를 만들 때 쓴다. / Return what changed since the last save, grouped as added/edited/removed — for building a save delta ("send only changes to the server"). */
2027
+ /**
2028
+ * 마지막 저장 이후 무엇이 바뀌었는지를 추가·수정·삭제 세 묶음으로 돌려준다. "변경분만 서버로 보내기"처럼 저장 시 델타를 만들 때 쓴다.
2029
+ *
2030
+ * Return what changed since the last save, grouped as added/edited/removed — for building a save delta ("send only changes to the server").
2031
+ *
2032
+ * 最後の保存以降に何が変わったかを、追加・修正・削除の 3 つの束にして返します。「変更分だけをサーバーへ送る」のように、保存時のデルタを作るときに使います。
2033
+ *
2034
+ * 把最后一次保存之后发生的变化,按添加、修改、删除三组返回。像「只把变更部分发往服务器」那样,制作保存时的增量时使用。
2035
+ */
684
2036
  getChanges(): {
685
2037
  added: T[];
686
2038
  edited: T[];
687
2039
  removed: T[];
688
2040
  };
689
- /** 수정된 행 목록. / Edited rows. */
2041
+ /**
2042
+ * 수정된 행 목록.
2043
+ *
2044
+ * Edited rows.
2045
+ *
2046
+ * 修正された行の一覧。
2047
+ *
2048
+ * 修改过的行的列表。
2049
+ */
690
2050
  getEditedRows(): T[];
691
- /** @deprecated 하위 호환 — getEditedRows() 권장. / Backward compat — prefer getEditedRows(). */
692
- getChangedRows(): T[];
693
- /** 행별 변경 필드·old/new 값 상세. / Per-row changed fields with old/new values. */
2051
+ /**
2052
+ * @deprecated 하위 호환 — getEditedRows() 권장.
2053
+ *
2054
+ * Backward compat — prefer getEditedRows().
2055
+ *
2056
+ * 後方互換 — getEditedRows() を推奨。
2057
+ *
2058
+ * 后方兼容 — 推荐 getEditedRows()。
2059
+ */
2060
+ getChangedRows(): T[];
2061
+ /**
2062
+ * 행별 변경 필드·old/new 값 상세.
2063
+ *
2064
+ * Per-row changed fields with old/new values.
2065
+ *
2066
+ * 行ごとの変更フィールドと old/new 値の詳細。
2067
+ *
2068
+ * 每行的变更字段与 old/new 值的详情。
2069
+ */
694
2070
  getChangedColumns(): Array<{
695
2071
  row: T;
696
2072
  fields: string[];
@@ -700,248 +2076,950 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
700
2076
  newValue: any;
701
2077
  }>;
702
2078
  }>;
703
- /** 추가된 행 목록. / Added rows. */
2079
+ /**
2080
+ * 추가된 행 목록.
2081
+ *
2082
+ * Added rows.
2083
+ *
2084
+ * 追加された行の一覧。
2085
+ *
2086
+ * 添加的行的列表。
2087
+ */
704
2088
  getAddedRows(): T[];
705
- /** 삭제된 행 목록. / Removed rows. */
2089
+ /**
2090
+ * 삭제된 행 목록.
2091
+ *
2092
+ * Removed rows.
2093
+ *
2094
+ * 削除された行の一覧。
2095
+ *
2096
+ * 删除的行的列表。
2097
+ */
706
2098
  getRemovedRows(): T[];
707
- /** 행의 원본(수정 전) 스냅샷. / Original (pre-edit) snapshot of the row. */
2099
+ /**
2100
+ * 행의 원본(수정 전) 스냅샷.
2101
+ *
2102
+ * Original (pre-edit) snapshot of the row.
2103
+ *
2104
+ * 行の元(修正前)のスナップショット。
2105
+ *
2106
+ * 行的原始(修改前)快照。
2107
+ */
708
2108
  getOriginalRow(rowIndex: number): T | undefined;
709
- /** stateField 값이 있는 행 목록. / Rows having a value in stateField. */
2109
+ /**
2110
+ * stateField 값이 있는 행 목록.
2111
+ *
2112
+ * Rows having a value in stateField.
2113
+ *
2114
+ * stateField に値がある行の一覧。
2115
+ *
2116
+ * stateField 中有值的行的列表。
2117
+ */
710
2118
  getRowsWithState(stateField: string): T[];
711
- /** @deprecated no-op stub — undo/redo 히스토리는 미구현. 변이 가드는 TriggerManager `before:*` 훅,
2119
+ /**
2120
+ * @deprecated no-op stub — undo/redo 히스토리는 미구현. 변이 가드는 TriggerManager `before:*` 훅,
712
2121
  * 변경 추적은 `getChanges()`/`getOriginalRow()` 를 사용.
713
- * / no-op stub — undo/redo history is not implemented. Use TriggerManager `before:*` hooks
714
- * for mutation guards and `getChanges()`/`getOriginalRow()` for change tracking. */
2122
+ *
2123
+ * no-op stub — undo/redo history is not implemented. Use TriggerManager `before:*` hooks
2124
+ * for mutation guards and `getChanges()`/`getOriginalRow()` for change tracking.
2125
+ *
2126
+ * no-op スタブ — undo/redo の履歴は未実装です。変更のガードには TriggerManager の `before:*` フックを、
2127
+ * 変更追跡には `getChanges()`/`getOriginalRow()` を使ってください。
2128
+ *
2129
+ * no-op 桩 — undo/redo 的历史未实现。变更的守卫请用 TriggerManager 的 `before:*` 钩子,
2130
+ * 变更追踪请用 `getChanges()`/`getOriginalRow()`。
2131
+ */
715
2132
  undo(): void;
716
- /** @deprecated no-op stub — undo/redo 히스토리 미구현(위 `undo()` 참조). / no-op stub — see `undo()` above. */
2133
+ /**
2134
+ * @deprecated no-op stub — undo/redo 히스토리 미구현(위 `undo()` 참조).
2135
+ *
2136
+ * no-op stub — see `undo()` above.
2137
+ *
2138
+ * no-op スタブ — undo/redo の履歴は未実装(上の `undo()` を参照)。
2139
+ *
2140
+ * no-op 桩 — undo/redo 的历史未实现(参见上面的 `undo()`)。
2141
+ */
717
2142
  redo(): void;
718
- /** @deprecated no-op stub — undo/redo 히스토리 자체가 없어 비울 것도 없음(위 `undo()` 참조). / no-op stub — there is no history to clear (see `undo()`). */
2143
+ /**
2144
+ * @deprecated no-op stub — undo/redo 히스토리 자체가 없어 비울 것도 없음(위 `undo()` 참조).
2145
+ *
2146
+ * no-op stub — there is no history to clear (see `undo()`).
2147
+ *
2148
+ * no-op スタブ — undo/redo の履歴自体がないため、消すものもありません(上の `undo()` を参照)。
2149
+ *
2150
+ * no-op 桩 — 本来就没有 undo/redo 的历史,因此也没有可清空的东西(参见上面的 `undo()`)。
2151
+ */
719
2152
  clearHistory(): void;
720
- /** 보이는 리프 컬럼 정의 목록. / Visible leaf column definitions. */
2153
+ /**
2154
+ * 보이는 리프 컬럼 정의 목록.
2155
+ *
2156
+ * Visible leaf column definitions.
2157
+ *
2158
+ * 表示されているリーフ列の定義一覧。
2159
+ *
2160
+ * 显示中的叶子列的定义列表。
2161
+ */
721
2162
  getColumnDefs(): ColumnDef<T>[];
722
- /** 숨김 포함 전체 리프 컬럼 정의. / All leaf column definitions including hidden. */
2163
+ /**
2164
+ * 숨김 포함 전체 리프 컬럼 정의.
2165
+ *
2166
+ * All leaf column definitions including hidden.
2167
+ *
2168
+ * 非表示を含む全リーフ列の定義。
2169
+ *
2170
+ * 包含隐藏列的全部叶子列的定义。
2171
+ */
723
2172
  getAllColumnDefs(): ColumnDef<T>[];
724
- /** 보이는 컬럼 수. / Number of visible columns. */
2173
+ /**
2174
+ * 보이는 컬럼 수.
2175
+ *
2176
+ * Number of visible columns.
2177
+ *
2178
+ * 表示されている列の数。
2179
+ *
2180
+ * 显示中的列数。
2181
+ */
725
2182
  getColumnCount(): number;
726
- /** 컬럼 구성 전체를 새 정의로 갈아끼우고 다시 그린다. 화면 모드에 따라 보여줄 열 세트를 통째로 바꿀 때 쓴다(개별 추가/삭제는 insertColumn/deleteColumn). / Replace the entire column set with new definitions and re-render — for swapping the whole column layout by view mode (use insertColumn/deleteColumn for single changes). */
2183
+ /**
2184
+ * 컬럼 구성 전체를 새 정의로 갈아끼우고 다시 그린다. 화면 모드에 따라 보여줄 열 세트를 통째로 바꿀 때 쓴다(개별 추가/삭제는 insertColumn/deleteColumn).
2185
+ *
2186
+ * Replace the entire column set with new definitions and re-render — for swapping the whole column layout by view mode (use insertColumn/deleteColumn for single changes).
2187
+ *
2188
+ * 列構成の全体を新しい定義に差し替えて描画し直します。画面モードに応じて見せる列のセットをまるごと変えるときに使います(個別の追加/削除は insertColumn/deleteColumn)。
2189
+ *
2190
+ * 把列构成的整体换成新定义并重新绘制。按画面模式整体更换要展示的列集合时使用(单个的添加/删除用 insertColumn/deleteColumn)。
2191
+ */
727
2192
  applyColumns(columns: ColumnDef<T>[]): void;
728
- /** 컬럼 1개를 삽입한다. / Insert one column. */
2193
+ /**
2194
+ * 컬럼 1개를 삽입한다.
2195
+ *
2196
+ * Insert one column.
2197
+ *
2198
+ * 列を 1 つ挿入します。
2199
+ *
2200
+ * 插入 1 个列。
2201
+ */
729
2202
  insertColumn(colDef: ColumnDef<T>, position?: Position): void;
730
- /** 컬럼을 삭제한다(해당 field 참조 수식은 #REF 처리). / Delete a column (formulas referencing the field become #REF). */
2203
+ /**
2204
+ * 컬럼을 삭제한다(해당 field 참조 수식은 #REF 처리).
2205
+ *
2206
+ * Delete a column (formulas referencing the field become #REF).
2207
+ *
2208
+ * 列を削除します(その field を参照する数式は #REF になります)。
2209
+ *
2210
+ * 删除列(引用该 field 的公式会变成 #REF)。
2211
+ */
731
2212
  deleteColumn(field: string): void;
732
2213
  private _reorderColumn;
733
- /** 컬럼(들)을 숨긴다. / Hide column(s). */
2214
+ /**
2215
+ * 컬럼(들)을 숨긴다.
2216
+ *
2217
+ * Hide column(s).
2218
+ *
2219
+ * 列を非表示にします。
2220
+ *
2221
+ * 隐藏列。
2222
+ */
734
2223
  hideColumn(field: string | string[]): void;
735
- /** 숨긴 컬럼(들)을 다시 표시한다. / Show hidden column(s). */
2224
+ /**
2225
+ * 숨긴 컬럼(들)을 다시 표시한다.
2226
+ *
2227
+ * Show hidden column(s).
2228
+ *
2229
+ * 非表示にした列を再び表示します。
2230
+ *
2231
+ * 把隐藏的列重新显示。
2232
+ */
736
2233
  showColumn(field: string | string[]): void;
737
- /** field 의 보이는 컬럼 인덱스(-1 = 없음). / Visible column index of the field (-1 when absent). */
2234
+ /**
2235
+ * field 의 보이는 컬럼 인덱스(-1 = 없음).
2236
+ *
2237
+ * Visible column index of the field (-1 when absent).
2238
+ *
2239
+ * field の表示列インデックス(-1 = なし)。
2240
+ *
2241
+ * field 的显示列索引(-1 = 没有)。
2242
+ */
738
2243
  getColumnIndex(field: string): number;
739
- /** 인덱스 위치의 field 명(없으면 ''). / Field name at the index ('' when absent). */
2244
+ /**
2245
+ * 인덱스 위치의 field 명(없으면 '').
2246
+ *
2247
+ * Field name at the index ('' when absent).
2248
+ *
2249
+ * インデックス位置の field 名(なければ '')。
2250
+ *
2251
+ * 索引位置的 field 名(没有则为 '')。
2252
+ */
740
2253
  getFieldAt(idx: number): string;
741
- /** 해당 컬럼의 값 배열. / Values of the column. */
2254
+ /**
2255
+ * 해당 컬럼의 값 배열.
2256
+ *
2257
+ * Values of the column.
2258
+ *
2259
+ * その列の値の配列。
2260
+ *
2261
+ * 该列的值的数组。
2262
+ */
742
2263
  getColValues(field: string, _all?: boolean): any[];
743
- /** 해당 컬럼의 고유 값 배열. / Unique values of the column. */
2264
+ /**
2265
+ * 해당 컬럼의 고유 값 배열.
2266
+ *
2267
+ * Unique values of the column.
2268
+ *
2269
+ * その列の一意な値の配列。
2270
+ *
2271
+ * 该列的唯一值的数组。
2272
+ */
744
2273
  getUniqueValues(field: string, all?: boolean): any[];
745
- /** @deprecated no-op stub — 컬럼 폭 일괄 설정은 구현돼 있지 않다(본문 없음). 폭은 `ColumnDef.width` 로
2274
+ /**
2275
+ * @deprecated no-op stub — 컬럼 폭 일괄 설정은 구현돼 있지 않다(본문 없음). 폭은 `ColumnDef.width` 로
746
2276
  * 지정하거나 헤더 경계를 드래그해 조절하며, 남는 공간은 그리드가 자동 배분한다.
747
- * / no-op stub — bulk width setting is not implemented (empty body). Set widths via `ColumnDef.width`
748
- * or by dragging header borders; the grid auto-distributes remaining space. */
2277
+ *
2278
+ * no-op stub — bulk width setting is not implemented (empty body). Set widths via `ColumnDef.width`
2279
+ * or by dragging header borders; the grid auto-distributes remaining space.
2280
+ *
2281
+ * no-op スタブ — 列幅の一括設定は実装されていません(本体なし)。幅は `ColumnDef.width` で指定するか、
2282
+ * ヘッダーの境界をドラッグして調整し、余った空間はグリッドが自動的に配分します。
2283
+ *
2284
+ * no-op 桩 — 列宽的批量设置未实现(无主体)。宽度请用 `ColumnDef.width` 指定,或拖拽表头的边界调整,
2285
+ * 剩余空间由表格自动分配。
2286
+ */
749
2287
  setColWidths(_widths: number[]): void;
750
- /** @deprecated no-op stub — 폭 계산 미구현으로 항상 빈 배열을 돌려준다(본문 없음). 폭 배분은 그리드가 자동 처리한다. / no-op stub — width calculation is not implemented; always returns [] (empty body). The grid distributes widths automatically. */
2288
+ /**
2289
+ * @deprecated no-op stub — 폭 계산 미구현으로 항상 빈 배열을 돌려준다(본문 없음). 폭 배분은 그리드가 자동 처리한다.
2290
+ *
2291
+ * no-op stub — width calculation is not implemented; always returns [] (empty body). The grid distributes widths automatically.
2292
+ *
2293
+ * no-op スタブ — 幅の計算は未実装のため、常に空配列を返します(本体なし)。幅の配分はグリッドが自動的に処理します。
2294
+ *
2295
+ * no-op 桩 — 宽度计算未实现,因此总是返回空数组(无主体)。宽度的分配由表格自动处理。
2296
+ */
751
2297
  calcColWidths(_fitToGrid?: boolean): number[];
752
- /** 선택된 행 데이터 목록. / Selected row data. */
2298
+ /**
2299
+ * 선택된 행 데이터 목록.
2300
+ *
2301
+ * Selected row data.
2302
+ *
2303
+ * 選択された行データの一覧。
2304
+ *
2305
+ * 选中的行数据的列表。
2306
+ */
753
2307
  getSelections(): T[];
754
- /** 활성 행 인덱스(-1 = 없음). / Active row index (-1 when none). */
2308
+ /**
2309
+ * 활성 행 인덱스(-1 = 없음).
2310
+ *
2311
+ * Active row index (-1 when none).
2312
+ *
2313
+ * アクティブ行のインデックス(-1 = なし)。
2314
+ *
2315
+ * 活动行的索引(-1 = 没有)。
2316
+ */
755
2317
  getActiveRow(): number;
756
- /** 지정 행을 활성/선택한다. / Activate (select) the given row. */
2318
+ /**
2319
+ * 지정 행을 활성/선택한다.
2320
+ *
2321
+ * Activate (select) the given row.
2322
+ *
2323
+ * 指定した行をアクティブ化(選択)します。
2324
+ *
2325
+ * 把指定的行激活(选中)。
2326
+ */
757
2327
  activate(index: number): void;
758
- /** 선택 해제. / Clear the selection. */
2328
+ /**
2329
+ * 선택 해제.
2330
+ *
2331
+ * Clear the selection.
2332
+ *
2333
+ * 選択の解除。
2334
+ *
2335
+ * 解除选择。
2336
+ */
759
2337
  deselect(): void;
760
- /** 체크된 행 목록({row, rowIndex}). / Checked rows ({row, rowIndex}). */
2338
+ /**
2339
+ * 체크된 행 목록({row, rowIndex}).
2340
+ *
2341
+ * Checked rows ({row, rowIndex}).
2342
+ *
2343
+ * チェックされた行の一覧({row, rowIndex})。
2344
+ *
2345
+ * 勾选的行的列表({row, rowIndex})。
2346
+ */
761
2347
  getChecked(): Array<{
762
2348
  row: T;
763
2349
  rowIndex: number;
764
2350
  }>;
765
- /** 체크된 행 데이터만 배열로. / Checked row data only. */
2351
+ /**
2352
+ * 체크된 행 데이터만 배열로.
2353
+ *
2354
+ * Checked row data only.
2355
+ *
2356
+ * チェックされた行データのみを配列で。
2357
+ *
2358
+ * 仅以数组返回勾选的行数据。
2359
+ */
766
2360
  getAllChecked(): T[];
767
- /** @deprecated no-op stub — id 기반 체크 미구현. 값 기준 체크는 `checkByValue(field, values)` 사용. / no-op stub — id-based checking not implemented; use `checkByValue(field, values)`. */
2361
+ /**
2362
+ * @deprecated no-op stub — id 기반 체크 미구현. 값 기준 체크는 `checkByValue(field, values)` 사용.
2363
+ *
2364
+ * no-op stub — id-based checking not implemented; use `checkByValue(field, values)`.
2365
+ *
2366
+ * no-op スタブ — id ベースのチェックは未実装。値基準のチェックは `checkByValue(field, values)` を使ってください。
2367
+ *
2368
+ * no-op 桩 — 基于 id 的勾选未实现。按值勾选请用 `checkByValue(field, values)`。
2369
+ */
768
2370
  checkById(_ids: string[]): void;
769
- /** @deprecated no-op stub — id 기반 체크 추가 미구현(위 `checkById()` 참조). `checkByValue` 사용. / no-op stub — see `checkById()`; use `checkByValue`. */
2371
+ /**
2372
+ * @deprecated no-op stub — id 기반 체크 추가 미구현(위 `checkById()` 참조). `checkByValue` 사용.
2373
+ *
2374
+ * no-op stub — see `checkById()`; use `checkByValue`.
2375
+ *
2376
+ * no-op スタブ — id ベースのチェック追加は未実装(上の `checkById()` を参照)。`checkByValue` を使ってください。
2377
+ *
2378
+ * no-op 桩 — 基于 id 的追加勾选未实现(参见上面的 `checkById()`)。请用 `checkByValue`。
2379
+ */
770
2380
  addCheckById(_ids: string[]): void;
771
- /** field 값이 values 에 포함되는 행을 체크한다. / Check rows whose field value is in values. */
2381
+ /**
2382
+ * field 값이 values 에 포함되는 행을 체크한다.
2383
+ *
2384
+ * Check rows whose field value is in values.
2385
+ *
2386
+ * field の値が values に含まれる行をチェックします。
2387
+ *
2388
+ * 勾选 field 的值包含在 values 中的行。
2389
+ */
772
2390
  checkByValue(field: string, values: any[]): void;
773
- /** @deprecated no-op stub — id 기반 체크 해제 미구현. 전체 해제는 `uncheckAll()` 사용. / no-op stub — id-based unchecking not implemented; use `uncheckAll()`. */
2391
+ /**
2392
+ * @deprecated no-op stub — id 기반 체크 해제 미구현. 전체 해제는 `uncheckAll()` 사용.
2393
+ *
2394
+ * no-op stub — id-based unchecking not implemented; use `uncheckAll()`.
2395
+ *
2396
+ * no-op スタブ — id ベースのチェック解除は未実装。全解除は `uncheckAll()` を使ってください。
2397
+ *
2398
+ * no-op 桩 — 基于 id 的取消勾选未实现。全部解除请用 `uncheckAll()`。
2399
+ */
774
2400
  uncheckById(_ids: string[]): void;
775
- /** 전체 체크 해제. / Uncheck all rows. */
2401
+ /**
2402
+ * 전체 체크 해제.
2403
+ *
2404
+ * Uncheck all rows.
2405
+ *
2406
+ * すべてのチェックを解除。
2407
+ *
2408
+ * 解除所有勾选。
2409
+ */
776
2410
  uncheckAll(): void;
777
2411
  /**
778
2412
  * 데이터를 정렬한다 — 헤더 클릭 없이 코드로 정렬을 걸 때 쓴다. 한 컬럼만 정렬하려면 field 와 방향을,
779
2413
  * 여러 컬럼을 우선순위대로 정렬하려면 SortItem 배열을 넘긴다. 정렬 전후로 `before/after:orderBy` 트리거가
780
2414
  * 돌고, 취소 가능한 `before:orderBy` 로 정렬을 막을 수도 있다.
781
- * / Sort the data from code without a header click. Pass a field + direction for a single column, or a
2415
+ *
2416
+ * Sort the data from code without a header click. Pass a field + direction for a single column, or a
782
2417
  * SortItem array to sort by several columns in priority order. `before/after:orderBy` triggers run
783
2418
  * around it, and a cancelable `before:orderBy` can veto the sort.
784
2419
  *
785
- * @param fieldOrList - field 명 또는 정렬 목록 / Field name or sort list
786
- * @param dir - 단일 field 일 때 방향(기본 'asc') / Direction for single-field form (default 'asc')
2420
+ * データを並べ替えます — ヘッダーをクリックせず、コードからソートを掛けるときに使います。1 列だけ並べ替えるなら
2421
+ * field と方向を、複数の列を優先順位どおりに並べ替えるなら SortItem の配列を渡します。ソートの前後で
2422
+ * `before/after:orderBy` トリガーが走り、キャンセル可能な `before:orderBy` でソートを止めることもできます。
2423
+ *
2424
+ * 对数据排序 — 不点击表头、而从代码施加排序时使用。只排 1 列就传 field 与方向,
2425
+ * 要按优先顺序排多列则传 SortItem 的数组。排序前后会跑 `before/after:orderBy` 触发器,
2426
+ * 也能用可取消的 `before:orderBy` 阻止排序。
2427
+ *
2428
+ * @param fieldOrList - field 명 또는 정렬 목록
2429
+ *
2430
+ * Field name or sort list
2431
+ *
2432
+ * field 名またはソートの一覧
2433
+ *
2434
+ * field 名或排序的列表
2435
+ *
2436
+ * @param dir - 단일 field 일 때 방향(기본 'asc')
2437
+ *
2438
+ * Direction for single-field form (default 'asc')
2439
+ *
2440
+ * 単一 field のときの方向(既定 'asc')
2441
+ *
2442
+ * 单一 field 时的方向(默认 'asc')
787
2443
  */
788
2444
  orderBy(fieldOrList: string | SortItem[], dir?: 'asc' | 'desc'): void;
789
- /** 정렬을 초기 상태로 되돌린다. / Reset sorting to the initial state. */
2445
+ /**
2446
+ * 정렬을 초기 상태로 되돌린다.
2447
+ *
2448
+ * Reset sorting to the initial state.
2449
+ *
2450
+ * ソートを初期状態に戻します。
2451
+ *
2452
+ * 把排序恢复到初始状态。
2453
+ */
790
2454
  resetOrder(): void;
791
2455
  /**
792
2456
  * 한 컬럼에 필터 조건을 걸어 조건에 맞는 행만 남긴다 — 필터 UI를 열지 않고 코드로 필터링할 때 쓴다.
793
2457
  * 같은 컬럼에 다시 호출하면 그 컬럼 필터가 교체되고, 전체 해제는 `resetFilter()` 를 쓴다. 정렬과 마찬가지로
794
2458
  * `before/after:setFilter` 트리거가 함께 돈다.
795
- * / Filter a column so only matching rows remain — for filtering from code without opening the filter UI.
2459
+ *
2460
+ * Filter a column so only matching rows remain — for filtering from code without opening the filter UI.
796
2461
  * Calling it again on the same column replaces that column's filter; clear everything via `resetFilter()`.
797
2462
  * Like sorting, `before/after:setFilter` triggers run around it.
798
2463
  *
799
- * @param field - 대상 컬럼 field / Target column field
800
- * @param filterItems - 필터 조건 목록 / Filter conditions
2464
+ * 1 つの列にフィルター条件を掛け、条件に合う行だけを残します — フィルター UI を開かずにコードから絞り込むときに
2465
+ * 使います。同じ列に再度呼び出すとその列のフィルターが差し替わり、全解除は `resetFilter()` を使います。ソートと
2466
+ * 同じく `before/after:setFilter` トリガーが併せて走ります。
2467
+ *
2468
+ * 对 1 个列施加筛选条件,只留下符合条件的行 — 不打开筛选 UI、而从代码筛选时使用。
2469
+ * 对同一列再次调用会替换该列的筛选,全部解除请用 `resetFilter()`。与排序一样,
2470
+ * `before/after:setFilter` 触发器也会一并运行。
2471
+ *
2472
+ * @param field - 대상 컬럼 field
2473
+ *
2474
+ * Target column field
2475
+ *
2476
+ * 対象となる列の field
2477
+ *
2478
+ * 目标列的 field
2479
+ *
2480
+ * @param filterItems - 필터 조건 목록
2481
+ *
2482
+ * Filter conditions
2483
+ *
2484
+ * フィルター条件の一覧
2485
+ *
2486
+ * 筛选条件的列表
801
2487
  */
802
2488
  setFilter(field: string, filterItems: FilterItem[]): void;
803
- /** 필터 해제(field 생략 시 전체). / Clear filters (all when field omitted). */
2489
+ /**
2490
+ * 필터 해제(field 생략 시 전체).
2491
+ *
2492
+ * Clear filters (all when field omitted).
2493
+ *
2494
+ * フィルターの解除(field を省略すると全体)。
2495
+ *
2496
+ * 解除筛选(省略 field 则为全体)。
2497
+ */
804
2498
  resetFilter(field?: string): void;
805
- /** F3-R13/MCCONNELL-03(P0): 정렬/필터 후 범위-보유(hasRangeRef) 수식 전부 dirty(§3.5). */
2499
+ /**
2500
+ * F3-R13/MCCONNELL-03(P0): 정렬/필터 후 범위-보유(hasRangeRef) 수식 전부 dirty(§3.5).
2501
+ *
2502
+ * F3-R13/MCCONNELL-03 (P0): after sort/filter, mark every range-bearing (hasRangeRef) formula dirty (§3.5).
2503
+ *
2504
+ * F3-R13/MCCONNELL-03(P0): ソート/フィルター後、範囲を保持する(hasRangeRef)数式をすべて dirty にします(§3.5)。
2505
+ *
2506
+ * F3-R13/MCCONNELL-03(P0): 排序/筛选后,把持有范围的(hasRangeRef)公式全部置为 dirty(§3.5)。
2507
+ */
806
2508
  private _recalcRangeBearingFormulas;
807
- /** 현재 필터 상태 스냅샷. / Snapshot of the current filter state. */
2509
+ /**
2510
+ * 현재 필터 상태 스냅샷.
2511
+ *
2512
+ * Snapshot of the current filter state.
2513
+ *
2514
+ * 現在のフィルター状態のスナップショット。
2515
+ *
2516
+ * 当前筛选状态的快照。
2517
+ */
808
2518
  getFilterState(): Record<string, FilterItem[]>;
809
- /** 필터 상태를 복원한다. / Restore a saved filter state. */
2519
+ /**
2520
+ * 필터 상태를 복원한다.
2521
+ *
2522
+ * Restore a saved filter state.
2523
+ *
2524
+ * フィルター状態を復元します。
2525
+ *
2526
+ * 恢复筛选状态。
2527
+ */
810
2528
  restoreFilter(state: Record<string, FilterItem[]>): void;
811
2529
  private _applyFilters;
812
- /** 왼쪽 n개 컬럼을 가로 스크롤에도 고정한다. 이름·id 같은 식별 컬럼을 항상 보이게 두고 나머지만 좌우로 훑을 때 쓴다(n=0 이면 고정 해제). / Freeze the leftmost n columns against horizontal scroll — keep identity columns (name/id) always visible while scrolling the rest (n=0 unfreezes). */
2530
+ /**
2531
+ * 왼쪽 n개 컬럼을 가로 스크롤에도 고정한다. 이름·id 같은 식별 컬럼을 항상 보이게 두고 나머지만 좌우로 훑을 때 쓴다(n=0 이면 고정 해제).
2532
+ *
2533
+ * Freeze the leftmost n columns against horizontal scroll — keep identity columns (name/id) always visible while scrolling the rest (n=0 unfreezes).
2534
+ *
2535
+ * 左から n 列を横スクロールに対しても固定します。名前・id といった識別用の列を常に見えるようにし、残りだけを左右に見ていくときに使います(n=0 なら固定を解除)。
2536
+ *
2537
+ * 把左起 n 列对横向滚动也固定。想让名称、id 这类识别用的列始终可见,只把其余部分左右浏览时使用(n=0 则解除固定)。
2538
+ */
813
2539
  freeze(n: number): void;
814
- /** 수동 병합: [{row, col, rowSpan?, colSpan?}] / Manual merge: [{row, col, rowSpan?, colSpan?}] */
2540
+ /**
2541
+ * 수동 병합: [{row, col, rowSpan?, colSpan?}]
2542
+ *
2543
+ * Manual merge: [{row, col, rowSpan?, colSpan?}]
2544
+ *
2545
+ * 手動結合: [{row, col, rowSpan?, colSpan?}]
2546
+ *
2547
+ * 手动合并: [{row, col, rowSpan?, colSpan?}]
2548
+ */
815
2549
  mergeCells(cells: MergeCell[]): void;
816
- /** 자동 병합: 지정 필드 컬럼에서 연속 같은 값을 rowSpan으로 묶는다. / Auto merge: consecutive equal values in the given field columns are merged via rowSpan. */
2550
+ /**
2551
+ * 자동 병합: 지정 필드 컬럼에서 연속 같은 값을 rowSpan으로 묶는다.
2552
+ *
2553
+ * Auto merge: consecutive equal values in the given field columns are merged via rowSpan.
2554
+ *
2555
+ * 自動結合: 指定した field の列で、連続する同じ値を rowSpan でまとめます。
2556
+ *
2557
+ * 自动合并: 在指定 field 的列中,把连续相同的值用 rowSpan 归并。
2558
+ */
817
2559
  autoMerge(fields: string[]): void;
818
- /** 병합 해제. / Clear all merges. */
2560
+ /**
2561
+ * 병합 해제.
2562
+ *
2563
+ * Clear all merges.
2564
+ *
2565
+ * 結合の解除。
2566
+ *
2567
+ * 解除合并。
2568
+ */
819
2569
  clearMerge(): void;
820
- /** @deprecated no-op stub — 행 고정(freeze rows) 미구현. 컬럼 고정만 지원하며 `freeze(n)` 사용. / no-op stub — frozen rows are not implemented; only column freezing via `freeze(n)`. */
2570
+ /**
2571
+ * @deprecated no-op stub — 행 고정(freeze rows) 미구현. 컬럼 고정만 지원하며 `freeze(n)` 사용.
2572
+ *
2573
+ * no-op stub — frozen rows are not implemented; only column freezing via `freeze(n)`.
2574
+ *
2575
+ * no-op スタブ — 行の固定(freeze rows)は未実装です。列の固定のみ対応しており、`freeze(n)` を使ってください。
2576
+ *
2577
+ * no-op 桩 — 行的固定(freeze rows)未实现。仅支持列的固定,请用 `freeze(n)`。
2578
+ */
821
2579
  freezeRows(_n: number): void;
822
- /** 지정한 필드 값이 같은 행끼리 접었다 펼 수 있는 그룹으로 묶는다(다중 필드면 계층 그룹). "부서별 → 팀별"처럼 데이터를 범주로 요약해 보여 줄 때 쓴다. 해제는 `clearGroup()`. / Group rows sharing the given field values into collapsible groups (multiple fields → nested groups) — for summarizing data by category ("by dept → by team"). Undo with `clearGroup()`. */
2580
+ /**
2581
+ * 지정한 필드 값이 같은 행끼리 접었다 펼 수 있는 그룹으로 묶는다(다중 필드면 계층 그룹). "부서별 → 팀별"처럼 데이터를 범주로 요약해 보여 줄 때 쓴다. 해제는 `clearGroup()`.
2582
+ *
2583
+ * Group rows sharing the given field values into collapsible groups (multiple fields → nested groups) — for summarizing data by category ("by dept → by team"). Undo with `clearGroup()`.
2584
+ *
2585
+ * 指定した field の値が同じ行どうしを、折りたたみ・展開できるグループにまとめます(複数 field なら階層グループ)。「部署別 → チーム別」のようにデータをカテゴリで要約して見せるときに使います。解除は `clearGroup()`。
2586
+ *
2587
+ * 把指定 field 的值相同的行,归并成可折叠、展开的组(多个 field 则为层级组)。想像「按部门 → 按团队」那样把数据按类别汇总展示时使用。解除用 `clearGroup()`。
2588
+ */
823
2589
  groupBy(fields: string[]): void;
824
- /** 그룹핑 해제. / Clear grouping. */
2590
+ /**
2591
+ * 그룹핑 해제.
2592
+ *
2593
+ * Clear grouping.
2594
+ *
2595
+ * グループ化の解除。
2596
+ *
2597
+ * 解除分组。
2598
+ */
825
2599
  clearGroup(): void;
826
- /** 모든 그룹 펼침. / Expand all groups. */
2600
+ /**
2601
+ * 모든 그룹 펼침.
2602
+ *
2603
+ * Expand all groups.
2604
+ *
2605
+ * すべてのグループを展開。
2606
+ *
2607
+ * 展开所有的组。
2608
+ */
827
2609
  expandAll(): void;
828
- /** 모든 그룹 접힘. / Collapse all groups. */
2610
+ /**
2611
+ * 모든 그룹 접힘.
2612
+ *
2613
+ * Collapse all groups.
2614
+ *
2615
+ * すべてのグループを折りたたみ。
2616
+ *
2617
+ * 折叠所有的组。
2618
+ */
829
2619
  collapseAll(): void;
830
- /** 트리 모드 활성화. / Enable tree mode. */
2620
+ /**
2621
+ * 트리 모드 활성화.
2622
+ *
2623
+ * Enable tree mode.
2624
+ *
2625
+ * ツリーモードの有効化。
2626
+ *
2627
+ * 启用树模式。
2628
+ */
831
2629
  enableTree(): void;
832
- /** 트리 모드 비활성화. / Disable tree mode. */
2630
+ /**
2631
+ * 트리 모드 비활성화.
2632
+ *
2633
+ * Disable tree mode.
2634
+ *
2635
+ * ツリーモードの無効化。
2636
+ *
2637
+ * 停用树模式。
2638
+ */
833
2639
  disableTree(): void;
834
- /** 지정 트리 노드 펼침/접힘. / Expand/collapse the given tree nodes. */
2640
+ /**
2641
+ * 지정 트리 노드 펼침/접힘.
2642
+ *
2643
+ * Expand/collapse the given tree nodes.
2644
+ *
2645
+ * 指定したツリーノードの展開/折りたたみ。
2646
+ *
2647
+ * 指定的树节点的展开/折叠。
2648
+ */
835
2649
  expandNodes(ids: any | any[], open?: boolean): void;
836
- /** 모든 트리 노드 펼침. / Expand all tree nodes. */
2650
+ /**
2651
+ * 모든 트리 노드 펼침.
2652
+ *
2653
+ * Expand all tree nodes.
2654
+ *
2655
+ * すべてのツリーノードを展開。
2656
+ *
2657
+ * 展开所有的树节点。
2658
+ */
837
2659
  expandAllNodes(): void;
838
- /** 모든 트리 노드 접힘. / Collapse all tree nodes. */
2660
+ /**
2661
+ * 모든 트리 노드 접힘.
2662
+ *
2663
+ * Collapse all tree nodes.
2664
+ *
2665
+ * すべてのツリーノードを折りたたみ。
2666
+ *
2667
+ * 折叠所有的树节点。
2668
+ */
839
2669
  collapseAllNodes(): void;
840
- /** 행 아래에 상세(마스터/디테일) 패널을 펼쳐 그 행의 하위 정보나 서브그리드를 보여 준다. 목록 행을 눌러 세부를 펼치는 UI를 코드로 여는 API다. rowRef 는 화면 위치(flat index)나 행 id({id})로 지정한다. / Expand the master/detail panel under a row to reveal its sub-info or a subgrid — the code path for a click-to-expand row UI. Reference the row by on-screen position (flat index) or id ({id}). */
2670
+ /**
2671
+ * 행 아래에 상세(마스터/디테일) 패널을 펼쳐 그 행의 하위 정보나 서브그리드를 보여 준다. 목록 행을 눌러 세부를 펼치는 UI를 코드로 여는 API다. rowRef 는 화면 위치(flat index)나 행 id({id})로 지정한다.
2672
+ *
2673
+ * Expand the master/detail panel under a row to reveal its sub-info or a subgrid — the code path for a click-to-expand row UI. Reference the row by on-screen position (flat index) or id ({id}).
2674
+ *
2675
+ * 行の下に詳細(マスター/ディテール)パネルを展開し、その行の下位情報やサブグリッドを見せます。一覧の行を押して詳細を開く UI を、コードから開く API です。rowRef は画面位置(flat index)または行 id({id})で指定します。
2676
+ *
2677
+ * 在行的下方展开明细(主从)面板,展示该行的下级信息或子表格。是把点击列表行以展开详情的 UI 从代码打开的 API。rowRef 用画面位置(flat index)或行 id({id})指定。
2678
+ */
841
2679
  expandRow(rowRef: number | {
842
2680
  id: string;
843
2681
  }): void;
844
- /** 행 상세 패널 접힘. / Collapse the detail panel. */
2682
+ /**
2683
+ * 행 상세 패널 접힘.
2684
+ *
2685
+ * Collapse the detail panel.
2686
+ *
2687
+ * 行の詳細パネルの折りたたみ。
2688
+ *
2689
+ * 折叠行的明细面板。
2690
+ */
845
2691
  collapseRow(rowRef: number | {
846
2692
  id: string;
847
2693
  }): void;
848
- /** 행 상세 패널 토글. / Toggle the detail panel. */
2694
+ /**
2695
+ * 행 상세 패널 토글.
2696
+ *
2697
+ * Toggle the detail panel.
2698
+ *
2699
+ * 行の詳細パネルのトグル。
2700
+ *
2701
+ * 切换行的明细面板。
2702
+ */
849
2703
  toggleRow(rowRef: number | {
850
2704
  id: string;
851
2705
  }): void;
852
- /** 행 상세 패널 펼침 여부. / Whether the detail panel is expanded. */
2706
+ /**
2707
+ * 행 상세 패널 펼침 여부.
2708
+ *
2709
+ * Whether the detail panel is expanded.
2710
+ *
2711
+ * 行の詳細パネルが展開されているかどうか。
2712
+ *
2713
+ * 行的明细面板是否已展开。
2714
+ */
853
2715
  isRowExpanded(rowRef: number | {
854
2716
  id: string;
855
2717
  }): boolean;
856
- /** 모든 상세 패널 접힘. / Collapse all detail panels. */
2718
+ /**
2719
+ * 모든 상세 패널 접힘.
2720
+ *
2721
+ * Collapse all detail panels.
2722
+ *
2723
+ * すべての詳細パネルの折りたたみ。
2724
+ *
2725
+ * 折叠所有的明细面板。
2726
+ */
857
2727
  collapseAllDetails(): void;
858
- /** 상세 인스턴스(renderer 반환값 또는 자동 서브그리드; 펼친 적 없으면 undefined). / Detail instance (renderer result or auto subgrid; undefined if never expanded). */
2728
+ /**
2729
+ * 상세 인스턴스(renderer 반환값 또는 자동 서브그리드; 펼친 적 없으면 undefined).
2730
+ *
2731
+ * Detail instance (renderer result or auto subgrid; undefined if never expanded).
2732
+ *
2733
+ * 詳細インスタンス(renderer の戻り値または自動サブグリッド。一度も展開していなければ undefined)。
2734
+ *
2735
+ * 明细实例(renderer 的返回值或自动子表格。一次都没展开过则为 undefined)。
2736
+ */
859
2737
  getDetailInstance<D = any>(rowRef: number | {
860
2738
  id: string;
861
2739
  }): D | undefined;
862
- /** 열려 있는 상세 패널의 폭을 부모 그리드 컬럼 폭에 다시 맞춘다. 컬럼 크기를 바꾼 뒤 상세 패널 정렬이 어긋나 보일 때 수동으로 재동기한다(보통은 자동 처리됨). / Re-sync open detail panels' widths to the parent column widths. Call it when panel alignment drifts after resizing columns (usually handled automatically). */
2740
+ /**
2741
+ * 열려 있는 상세 패널의 폭을 부모 그리드 컬럼 폭에 다시 맞춘다. 컬럼 크기를 바꾼 뒤 상세 패널 정렬이 어긋나 보일 때 수동으로 재동기한다(보통은 자동 처리됨).
2742
+ *
2743
+ * Re-sync open detail panels' widths to the parent column widths. Call it when panel alignment drifts after resizing columns (usually handled automatically).
2744
+ *
2745
+ * 開いている詳細パネルの幅を、親グリッドの列幅に合わせ直します。列のサイズを変えたあとに詳細パネルの位置がずれて見えるとき、手動で同期させます(通常は自動的に処理されます)。
2746
+ *
2747
+ * 把打开着的明细面板的宽度,重新对齐到父表格的列宽。改变列的尺寸后明细面板的对齐看起来错位时,手动同步(通常会自动处理)。
2748
+ */
863
2749
  resyncPanelWidths(): void;
864
- /** @deprecated no-op stub — 부모 지정 트리행 삽입 미구현. 평면 삽입은 `insertRow(item, pos)`,
2750
+ /**
2751
+ * @deprecated no-op stub — 부모 지정 트리행 삽입 미구현. 평면 삽입은 `insertRow(item, pos)`,
865
2752
  * 트리 구성은 `enableTree()`/`groupBy(fields)` 사용.
866
- * / no-op stub — parented tree-row insertion is not implemented. Use `insertRow(item, pos)`
867
- * for flat insertion and `enableTree()`/`groupBy(fields)` for tree structure. */
2753
+ *
2754
+ * no-op stub — parented tree-row insertion is not implemented. Use `insertRow(item, pos)`
2755
+ * for flat insertion and `enableTree()`/`groupBy(fields)` for tree structure.
2756
+ *
2757
+ * no-op スタブ — 親を指定したツリー行の挿入は未実装です。平坦な挿入は `insertRow(item, pos)` を、
2758
+ * ツリーの構成は `enableTree()`/`groupBy(fields)` を使ってください。
2759
+ *
2760
+ * no-op 桩 — 指定父节点的树行插入未实现。平坦的插入请用 `insertRow(item, pos)`,
2761
+ * 树的构成请用 `enableTree()`/`groupBy(fields)`。
2762
+ */
868
2763
  addTreeRow(_item: Partial<T>, _pid: string, _pos?: Position): void;
869
- /** 현재 그리드 내용을 엑셀(xlsx) 파일로 내려받게 한다. 문자열을 넘기면 파일명으로, 옵션 객체로는 컬럼·범위 등을 세밀 지정한다(기본은 보이는 데이터 전부). / Download the current grid as an Excel (xlsx) file. A string is used as the filename; an options object fine-tunes columns/scope (defaults to all visible data). */
2764
+ /**
2765
+ * 현재 그리드 내용을 엑셀(xlsx) 파일로 내려받게 한다. 문자열을 넘기면 파일명으로, 옵션 객체로는 컬럼·범위 등을 세밀 지정한다(기본은 보이는 데이터 전부).
2766
+ *
2767
+ * Download the current grid as an Excel (xlsx) file. A string is used as the filename; an options object fine-tunes columns/scope (defaults to all visible data).
2768
+ *
2769
+ * 現在のグリッドの内容を Excel(xlsx)ファイルとしてダウンロードさせます。文字列を渡すとファイル名として、オプションオブジェクトでは列・範囲などを細かく指定します(既定は見えているデータ全部)。
2770
+ *
2771
+ * 把当前表格的内容作为 Excel(xlsx)文件下载。传入字符串则作为文件名,用选项对象可细致指定列、范围等(默认是可见数据的全部)。
2772
+ */
870
2773
  exportExcel(options?: ExportOptions | string): void;
871
- /** 현재 그리드 내용을 CSV 파일로 내려받게 한다(가벼운 텍스트 교환용). 옵션은 exportExcel 과 동일. / Download the current grid as a CSV file (lightweight text interchange); same options as exportExcel. */
2774
+ /**
2775
+ * 현재 그리드 내용을 CSV 파일로 내려받게 한다(가벼운 텍스트 교환용). 옵션은 exportExcel 과 동일.
2776
+ *
2777
+ * Download the current grid as a CSV file (lightweight text interchange); same options as exportExcel.
2778
+ *
2779
+ * 現在のグリッドの内容を CSV ファイルとしてダウンロードさせます(軽量なテキスト交換用)。オプションは exportExcel と同じです。
2780
+ *
2781
+ * 把当前表格的内容作为 CSV 文件下载(用于轻量的文本交换)。选项与 exportExcel 相同。
2782
+ */
872
2783
  exportCsv(options?: ExportOptions | string): void;
873
- /** 현재 그리드 내용을 JSON 파일로 내려받게 한다(원본 객체 구조 보존). 옵션은 exportExcel 과 동일. / Download the current grid as a JSON file (preserves the object structure); same options as exportExcel. */
2784
+ /**
2785
+ * 현재 그리드 내용을 JSON 파일로 내려받게 한다(원본 객체 구조 보존). 옵션은 exportExcel 과 동일.
2786
+ *
2787
+ * Download the current grid as a JSON file (preserves the object structure); same options as exportExcel.
2788
+ *
2789
+ * 現在のグリッドの内容を JSON ファイルとしてダウンロードさせます(元のオブジェクト構造を保持)。オプションは exportExcel と同じです。
2790
+ *
2791
+ * 把当前表格的内容作为 JSON 文件下载(保留原始的对象结构)。选项与 exportExcel 相同。
2792
+ */
874
2793
  exportJson(options?: ExportOptions | string): void;
875
- /** 인쇄용 창을 연다. / Open the print view. */
2794
+ /**
2795
+ * 인쇄용 창을 연다.
2796
+ *
2797
+ * Open the print view.
2798
+ *
2799
+ * 印刷用のウィンドウを開きます。
2800
+ *
2801
+ * 打开打印用的窗口。
2802
+ */
876
2803
  print(options?: {
877
2804
  title?: string;
878
2805
  excludeFields?: string[];
879
2806
  }): void;
880
2807
  /**
881
- * 데이터 배열 변환. / Convert the data set.
2808
+ * 데이터 배열 변환.
2809
+ *
2810
+ * Convert the data set.
2811
+ *
2812
+ * データ配列の変換。
2813
+ *
2814
+ * 数据数组的转换。
2815
+ *
2816
+ * @param keyValue - true = 객체 배열(기본), false = 값 2D 배열
882
2817
  *
883
- * @param keyValue - true = 객체 배열(기본), false = 값 2D 배열 / true = object array (default), false = 2D value array
2818
+ * true = object array (default), false = 2D value array
2819
+ *
2820
+ * true = オブジェクト配列(既定)、false = 値の 2 次元配列
2821
+ *
2822
+ * true = 对象数组(默认),false = 值的二维数组
884
2823
  */
885
2824
  toArray(keyValue?: boolean): any[];
886
2825
  /**
887
2826
  * 사용자가 검색 결과나 차트 클릭으로 특정 행을 가리켰을 때, 그 행이 화면에 보이도록 스크롤하고 선택 표시까지
888
2827
  * 해 준다. 큰 데이터에서 "어디였더라"를 없애는 이동 도우미다.
889
- * / When a search result or chart click points at a specific row, scroll it into view and select it.
2828
+ *
2829
+ * When a search result or chart click points at a specific row, scroll it into view and select it.
890
2830
  * A navigation helper that removes the "where was it again?" problem in large data.
891
2831
  *
892
- * @param rowIndex - 이동할 행의 위치(flat index) / Position (flat index) of the row to jump to
2832
+ * ユーザーが検索結果やチャートのクリックで特定の行を指し示したとき、その行が画面に見えるようスクロールし、選択表示
2833
+ * までを行います。大きなデータで「どこだったか」をなくす移動のヘルパーです。
2834
+ *
2835
+ * 当用户通过搜索结果或点击图表指向特定的行时,滚动到该行在画面上可见的位置,并做出选中标示。
2836
+ * 是在大数据中消除「刚才在哪来着」的移动辅助函数。
2837
+ *
2838
+ * @param rowIndex - 이동할 행의 위치(flat index)
2839
+ *
2840
+ * Position (flat index) of the row to jump to
2841
+ *
2842
+ * 移動先の行の位置(flat index)
2843
+ *
2844
+ * 要移动到的行的位置(flat index)
893
2845
  */
894
2846
  jumpToRow(rowIndex: number): void;
895
- /** @deprecated no-op stub — 특정 컬럼으로 가로 스크롤 이동 미구현. 행 이동은 `jumpToRow(rowIndex)` 사용. / no-op stub — horizontal jump-to-column is not implemented; use `jumpToRow(rowIndex)`. */
2847
+ /**
2848
+ * @deprecated no-op stub — 특정 컬럼으로 가로 스크롤 이동 미구현. 행 이동은 `jumpToRow(rowIndex)` 사용.
2849
+ *
2850
+ * no-op stub — horizontal jump-to-column is not implemented; use `jumpToRow(rowIndex)`.
2851
+ *
2852
+ * no-op スタブ — 特定の列への横スクロール移動は未実装です。行の移動は `jumpToRow(rowIndex)` を使ってください。
2853
+ *
2854
+ * no-op 桩 — 向特定列的横向滚动移动未实现。行的移动请用 `jumpToRow(rowIndex)`。
2855
+ */
896
2856
  jumpToCol(_field: string): void;
897
- /** 현재 스크롤 좌표. / Current scroll position. */
2857
+ /**
2858
+ * 현재 스크롤 좌표.
2859
+ *
2860
+ * Current scroll position.
2861
+ *
2862
+ * 現在のスクロール座標。
2863
+ *
2864
+ * 当前的滚动坐标。
2865
+ */
898
2866
  getScrollPos(): {
899
2867
  x: number;
900
2868
  y: number;
901
2869
  };
902
- /** 푸터 정의를 교체하고 다시 그린다. / Replace footer definitions and re-render the footer. */
2870
+ /**
2871
+ * 푸터 정의를 교체하고 다시 그린다.
2872
+ *
2873
+ * Replace footer definitions and re-render the footer.
2874
+ *
2875
+ * フッター定義を差し替えて描画し直します。
2876
+ *
2877
+ * 替换页脚定义并重新绘制。
2878
+ */
903
2879
  setFooter(fd: any[]): void;
904
- /** 푸터 집계값 목록. / Computed footer values. */
2880
+ /**
2881
+ * 푸터 집계값 목록.
2882
+ *
2883
+ * Computed footer values.
2884
+ *
2885
+ * フッターの集計値の一覧。
2886
+ *
2887
+ * 页脚的汇总值的列表。
2888
+ */
905
2889
  getFooterData(): any[];
906
- /** 특정 field 의 푸터 집계값(없으면 null). / Footer value of the field (null when absent). */
2890
+ /**
2891
+ * 특정 field 의 푸터 집계값(없으면 null).
2892
+ *
2893
+ * Footer value of the field (null when absent).
2894
+ *
2895
+ * 特定の field のフッター集計値(なければ null)。
2896
+ *
2897
+ * 特定 field 的页脚汇总值(没有则为 null)。
2898
+ */
907
2899
  getFooterValue(field: string): any;
908
2900
  private _renderFooterEl;
909
- /** 그리드 크기를 변경하고 재배치한다. / Resize the grid and relayout. */
2901
+ /**
2902
+ * 그리드 크기를 변경하고 재배치한다.
2903
+ *
2904
+ * Resize the grid and relayout.
2905
+ *
2906
+ * グリッドのサイズを変更して再配置します。
2907
+ *
2908
+ * 变更表格的尺寸并重新布局。
2909
+ */
910
2910
  resize(w?: number, h?: number): void;
911
- /** 색 테마(data-og-theme)를 전환한다. / Switch the color theme (data-og-theme). */
2911
+ /**
2912
+ * 색 테마(data-og-theme)를 전환한다.
2913
+ *
2914
+ * Switch the color theme (data-og-theme).
2915
+ *
2916
+ * カラーテーマ(data-og-theme)を切り替えます。
2917
+ *
2918
+ * 切换颜色主题(data-og-theme)。
2919
+ */
912
2920
  setTheme(theme: string): void;
913
- /** 색 축 CSS 변수 1개를 런타임 설정한다. / Set one color-axis CSS variable at runtime. */
2921
+ /**
2922
+ * 색 축 CSS 변수 1개를 런타임 설정한다.
2923
+ *
2924
+ * Set one color-axis CSS variable at runtime.
2925
+ *
2926
+ * 色軸の CSS 変数を 1 つ、ランタイムで設定します。
2927
+ *
2928
+ * 在运行时设置 1 个颜色轴的 CSS 变量。
2929
+ */
914
2930
  setThemeVar(k: string, v: string): void;
915
2931
  /**
916
2932
  * 이 그리드의 스킨(형태 축)을 런타임에 바꾼다 — `defineSkin` 으로 등록해 둔 스킨 id 를 골라 적용한다.
917
2933
  * 색 테마와는 완전히 별개라 색은 하나도 건드리지 않고 모서리·외곽선 같은 "생김새"만 바뀐다. 전환하면
918
2934
  * 형태 토큰을 다시 해석해야 하므로 헤더와 본문을 한 번 다시 그린다(스킨을 쓸 때만 드는 비용).
919
- * / Switch this grid's skin (the form axis) at runtime — pick a skin id registered via `defineSkin`.
2935
+ *
2936
+ * Switch this grid's skin (the form axis) at runtime — pick a skin id registered via `defineSkin`.
920
2937
  * Fully separate from color themes, so no color changes; only the "look" (radius, border, …) changes.
921
2938
  * Switching re-resolves form tokens, so the header and body are re-rendered once (a cost paid only when
922
2939
  * you use skins).
923
2940
  *
924
- * @param skin - 적용할 스킨 id('default' = 기본 형태) / Skin id to apply ('default' = stock form)
2941
+ * このグリッドのスキン(形状軸)をランタイムで変えます — `defineSkin` で登録しておいたスキン id を選んで適用します。
2942
+ * カラーテーマとは完全に別なので、色にはいっさい触れず、角丸・輪郭線といった「見た目」だけが変わります。切り替えると
2943
+ * 形状トークンを解決し直す必要があるため、ヘッダーと本文を 1 回描画し直します(スキンを使うときだけ掛かるコスト)。
2944
+ *
2945
+ * 在运行时改变这个表格的皮肤(形状轴)— 挑选用 `defineSkin` 注册好的皮肤 id 应用。
2946
+ * 与颜色主题完全无关,因此完全不碰颜色,只改变圆角、轮廓线这类「外观」。切换时需要重新解析
2947
+ * 形状 token,因此把表头与主体重新绘制 1 次(只有使用皮肤时才付出的成本)。
2948
+ *
2949
+ * @param skin - 적용할 스킨 id('default' = 기본 형태)
2950
+ *
2951
+ * Skin id to apply ('default' = stock form)
2952
+ *
2953
+ * 適用するスキン id('default' = 標準の形状)
2954
+ *
2955
+ * 要应用的皮肤 id('default' = 默认形状)
925
2956
  */
926
2957
  setSkin(skin: string): void;
927
- /** 지금 적용된 스킨 id 를 돌려준다('default' = 기본 형태). 어떤 스킨이 걸려 있는지 확인하거나 토글할 때 쓴다. / Return the currently applied skin id ('default' = stock form) — to check or toggle which skin is active. */
2958
+ /**
2959
+ * 지금 적용된 스킨 id 를 돌려준다('default' = 기본 형태). 어떤 스킨이 걸려 있는지 확인하거나 토글할 때 쓴다.
2960
+ *
2961
+ * Return the currently applied skin id ('default' = stock form) — to check or toggle which skin is active.
2962
+ *
2963
+ * いま適用されているスキン id を返します('default' = 標準の形状)。どのスキンが掛かっているかを確認したり、トグルしたりするときに使います。
2964
+ *
2965
+ * 返回当前已应用的皮肤 id('default' = 默认形状)。用于确认挂着哪个皮肤,或做切换。
2966
+ */
928
2967
  getSkin(): string;
929
2968
  /**
930
2969
  * 이 그리드 인스턴스에서만 특정 아이콘 role(정렬 화살표·삭제 아이콘 등) 하나를 다른 아이콘으로 바꾼다.
931
2970
  * 전역 `defineIconSet` 과 달리 다른 그리드에는 영향을 주지 않는다(인스턴스별 격리) — 한 화면에서만 아이콘을
932
2971
  * 커스터마이즈하고 싶을 때 쓴다. svgOrKey 는 알려진 아이콘 key 이거나 원시 SVG 본문이며, 없는 role/글리프를
933
2972
  * 넘겨도 안전하게 폴백한다(throw 하지 않음). 체이닝용 this 를 돌려준다.
934
- * / Replace a single icon role (sort arrow, delete icon, …) for this grid instance only. Unlike the
2973
+ *
2974
+ * Replace a single icon role (sort arrow, delete icon, …) for this grid instance only. Unlike the
935
2975
  * global `defineIconSet`, it does not affect other grids (per-instance isolation) — use it to customize
936
2976
  * icons on one screen. svgOrKey is a known icon key or raw SVG body; unknown roles/glyphs fall back
937
2977
  * safely (never throws). Returns this for chaining.
938
2978
  *
939
- * @param role - 시맨틱 아이콘 role / Semantic icon role
940
- * @param svgOrKey - 아이콘 key 또는 원시 SVG / Icon key or raw SVG
941
- * @returns 체이닝용 this / this for chaining
2979
+ * このグリッドインスタンスでのみ、特定のアイコン role(ソート矢印・削除アイコンなど)を 1 つ別のアイコンに差し替え
2980
+ * ます。グローバルな `defineIconSet` と違い、ほかのグリッドには影響しません(インスタンスごとの分離) — 1 つの画面
2981
+ * だけでアイコンをカスタマイズしたいときに使います。svgOrKey は既知のアイコン key、または生の SVG 本体で、存在しない
2982
+ * role/グリフを渡しても安全にフォールバックします(throw しません)。チェーン用に this を返します。
2983
+ *
2984
+ * 只在这个表格实例上,把特定的图标 role(排序箭头、删除图标等)换成别的图标。
2985
+ * 与全局的 `defineIconSet` 不同,不会影响其他表格(按实例隔离)— 想只在一个画面上自定义图标时使用。
2986
+ * svgOrKey 是已知的图标 key,或原始 SVG 主体;传入不存在的 role/字形也会安全回退(不会 throw)。
2987
+ * 返回用于链式调用的 this。
2988
+ *
2989
+ * @param role - 시맨틱 아이콘 role
2990
+ *
2991
+ * Semantic icon role
2992
+ *
2993
+ * セマンティックなアイコン role
2994
+ *
2995
+ * 语义图标 role
2996
+ *
2997
+ * @param svgOrKey - 아이콘 key 또는 원시 SVG
2998
+ *
2999
+ * Icon key or raw SVG
3000
+ *
3001
+ * アイコン key または生の SVG
3002
+ *
3003
+ * 图标 key 或原始 SVG
3004
+ *
3005
+ * @returns 체이닝용 this
3006
+ *
3007
+ * this for chaining
3008
+ *
3009
+ * チェーン用の this
3010
+ *
3011
+ * 用于链式调用的 this
942
3012
  */
943
3013
  setIcon(role: string, svgOrKey: string): this;
944
- /** 아이콘 role 을 실제 렌더용 마크업(또는 SVGElement)으로 해석한다. 인스턴스 오버라이드(setIcon)가 있으면 그것을, 없으면 전역 아이콘을 쓴다. 커스텀 셀·버튼에 그리드와 같은 아이콘을 직접 그려 넣을 때 쓴다. / Resolve an icon role to render markup (or an SVGElement), using this instance's override (setIcon) first, then the global icon — for drawing grid-consistent icons into custom cells/buttons. */
3014
+ /**
3015
+ * 아이콘 role 을 실제 렌더용 마크업(또는 SVGElement)으로 해석한다. 인스턴스 오버라이드(setIcon)가 있으면 그것을, 없으면 전역 아이콘을 쓴다. 커스텀 셀·버튼에 그리드와 같은 아이콘을 직접 그려 넣을 때 쓴다.
3016
+ *
3017
+ * Resolve an icon role to render markup (or an SVGElement), using this instance's override (setIcon) first, then the global icon — for drawing grid-consistent icons into custom cells/buttons.
3018
+ *
3019
+ * アイコン role を実際のレンダリング用マークアップ(または SVGElement)へ解決します。インスタンスのオーバーライド(setIcon)があればそれを、なければグローバルのアイコンを使います。カスタムセルやボタンに、グリッドと同じアイコンを自分で描き込むときに使います。
3020
+ *
3021
+ * 把图标 role 解析为实际渲染用的标记(或 SVGElement)。有实例的覆盖(setIcon)就用它,没有则用全局的图标。想在自定义单元格或按钮上亲手画入与表格相同的图标时使用。
3022
+ */
945
3023
  renderIcon(role: string, opts?: {
946
3024
  size?: number;
947
3025
  title?: string;
@@ -952,50 +3030,154 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
952
3030
  * `lang` 속성을 로케일 Intl 태그로 갱신(스크린리더 발음 전환), 상주 크롬(페이지네이션/찾기)의
953
3031
  * 라벨을 새로 그리고, 캐시된 필터 패널을 무효화한 뒤 헤더+가시창을 1회 재렌더한다.
954
3032
  * 미등록 로케일은 throw 하지 않고 폴백 유지(never-throw). 전환 후 `localeChange` 이벤트 발화.
955
- * / i18n: switch this instance's UI locale. setSkin camp — data-immutable + partial chrome/viewport
3033
+ *
3034
+ * i18n: switch this instance's UI locale. setSkin camp — data-immutable + partial chrome/viewport
956
3035
  * re-render. Updates `lang` to the locale's Intl tag (screen-reader pronunciation), refreshes
957
3036
  * resident chrome labels (pagination/find), invalidates the cached filter panel, then re-renders
958
3037
  * the header + visible window once. Unknown locales never throw. Emits `localeChange` afterwards.
959
3038
  *
960
- * @param locale - 로케일 id(예 'en') / Locale id (e.g. 'en')
3039
+ * i18n: このインスタンスの UI ロケールを切り替えます。setSkin の陣営 — データは不変 + クロム/可視領域の部分再
3040
+ * レンダーです。`lang` 属性をロケールの Intl タグに更新し(スクリーンリーダーの発音を切り替え)、常駐クロム
3041
+ * (ページネーション/検索)のラベルを描き直し、キャッシュされたフィルターパネルを無効化したうえで、ヘッダー+可視
3042
+ * 領域を 1 回再レンダーします。未登録のロケールは throw せずフォールバックを維持します(never-throw)。切り替え後に
3043
+ * `localeChange` イベントを発火します。
3044
+ *
3045
+ * i18n: 切换这个实例的 UI 区域设置。属于 setSkin 阵营 — 数据不变 + 外壳/可视区的部分重新渲染。
3046
+ * 把 `lang` 属性更新为区域设置的 Intl 标签(切换屏幕阅读器的发音),重绘常驻外壳
3047
+ * (分页/查找)的标签,使缓存的筛选面板失效,然后把表头 + 可视区重新渲染 1 次。
3048
+ * 未注册的区域设置不会 throw,而是保持回退(never-throw)。切换后触发 `localeChange` 事件。
3049
+ *
3050
+ * @param locale - 로케일 id(예 'en')
3051
+ *
3052
+ * Locale id (e.g. 'en')
3053
+ *
3054
+ * ロケール id(例 'en')
3055
+ *
3056
+ * 区域设置 id(例 'en')
3057
+ *
961
3058
  * @example
962
3059
  * grid.setLocale('en');
963
3060
  */
964
3061
  setLocale(locale: string): void;
965
- /** i18n: 현재 인스턴스 로케일 id('ko' = 기본). / i18n: current instance locale id ('ko' = default). */
3062
+ /**
3063
+ * i18n: 현재 인스턴스 로케일 id('ko' = 기본).
3064
+ *
3065
+ * i18n: current instance locale id ('ko' = default).
3066
+ *
3067
+ * i18n: 現在のインスタンスのロケール id('ko' = 既定)。
3068
+ *
3069
+ * i18n: 当前实例的区域设置 id('ko' = 默认)。
3070
+ */
966
3071
  getLocale(): string;
967
3072
  /**
968
3073
  * i18n: 이 인스턴스만 단일 메시지를 오버라이드(setIcon 동형 — 첫 호출 때 child 지연 생성, 멀티그리드 격리).
969
- * 자동 재렌더는 하지 않는다(다음 렌더/setLocale 때 반영). / i18n: override a single message for this
970
- * instance only (isomorphic to setIcon — lazy child on first call, multi-grid isolation). No auto
971
- * re-render (applied on the next render/setLocale).
3074
+ * 자동 재렌더는 하지 않는다(다음 렌더/setLocale 때 반영).
3075
+ *
3076
+ * i18n: override a single message for this instance only (isomorphic to setIcon — lazy child on first
3077
+ * call, multi-grid isolation). No auto re-render (applied on the next render/setLocale).
3078
+ *
3079
+ * i18n: このインスタンスだけで単一のメッセージをオーバーライドします(setIcon と同型 — 初回呼び出し時に child を
3080
+ * 遅延生成、マルチグリッドで分離)。自動の再レンダーは行いません(次のレンダー/setLocale 時に反映)。
3081
+ *
3082
+ * i18n: 只在这个实例上覆盖单条消息(与 setIcon 同型 — 首次调用时延迟生成 child,多表格隔离)。
3083
+ * 不做自动的重新渲染(在下一次渲染/setLocale 时反映)。
3084
+ *
3085
+ * @param key - dot-key 메시지 키(예 'filter.apply')
3086
+ *
3087
+ * dot-key message key (e.g. 'filter.apply')
3088
+ *
3089
+ * dot-key 形式のメッセージキー(例 'filter.apply')
3090
+ *
3091
+ * dot-key 形式的消息键(例 'filter.apply')
3092
+ *
3093
+ * @param value - 문자열('{name}' 보간) 또는 함수
3094
+ *
3095
+ * string ('{name}' interpolation) or a function
3096
+ *
3097
+ * 文字列('{name}' の補間)または関数
3098
+ *
3099
+ * 字符串('{name}' 插值)或函数
3100
+ *
3101
+ * @returns 체이닝용 this
3102
+ *
3103
+ * this for chaining
3104
+ *
3105
+ * チェーン用の this
972
3106
  *
973
- * @param key - dot-key 메시지 키(예 'filter.apply') / dot-key message key (e.g. 'filter.apply')
974
- * @param value - 문자열('{name}' 보간) 또는 함수 / string ('{name}' interpolation) or a function
975
- * @returns 체이닝용 this / this for chaining
3107
+ * 用于链式调用的 this
976
3108
  */
977
3109
  setMessage(key: LocaleMessageKey | string, value: MessageValue): this;
978
3110
  /**
979
3111
  * i18n: 메시지를 해석한다(인스턴스 오버라이드 우선 → 활성 로케일 → ko → 키 원문). throw 하지 않음 —
980
- * 렌더 루프(셀 aria) 소비자용. / i18n: resolve a message (instance override → active locale → ko →
981
- * the key itself). Never throws — for render-loop consumers (cell aria).
3112
+ * 렌더 루프(셀 aria) 소비자용.
982
3113
  *
983
- * @param key - dot-key 메시지 키 / dot-key message key
984
- * @param params - `{name}` 보간 파라미터 / `{name}` interpolation params
985
- * @returns 해석된 문자열(미등록 키면 키 원문) / Resolved string (the key itself when unknown)
3114
+ * i18n: resolve a message (instance override → active locale → ko → the key itself). Never throws —
3115
+ * for render-loop consumers (cell aria).
3116
+ *
3117
+ * i18n: メッセージを解決します(インスタンスのオーバーライド優先 → 有効なロケール → ko → キーの原文)。throw しま
3118
+ * せん — レンダーループ(セルの aria)の利用者向けです。
3119
+ *
3120
+ * i18n: 解析消息(实例的覆盖优先 → 有效的区域设置 → ko → 键的原文)。不会 throw —
3121
+ * 面向渲染循环(单元格的 aria)的使用者。
3122
+ *
3123
+ * @param key - dot-key 메시지 키
3124
+ *
3125
+ * dot-key message key
3126
+ *
3127
+ * dot-key 形式のメッセージキー
3128
+ *
3129
+ * dot-key 形式的消息键
3130
+ *
3131
+ * @param params - `{name}` 보간 파라미터
3132
+ *
3133
+ * `{name}` interpolation params
3134
+ *
3135
+ * `{name}` の補間パラメータ
3136
+ *
3137
+ * `{name}` 的插值参数
3138
+ *
3139
+ * @returns 해석된 문자열(미등록 키면 키 원문)
3140
+ *
3141
+ * Resolved string (the key itself when unknown)
3142
+ *
3143
+ * 解決された文字列(未登録のキーならキーの原文)
3144
+ *
3145
+ * 解析后的字符串(未注册的键则为键的原文)
986
3146
  */
987
3147
  t(key: LocaleMessageKey | string, params?: Record<string, string | number>): string;
988
3148
  /**
989
3149
  * 형태(FORM 축) CSS 변수 하나를 런타임에 덮어쓴다 — 색 변수를 바꾸는 `setThemeVar` 의 형태 축 짝이다.
990
3150
  * 스킨 하나를 통째로 만들 필요 없이 모서리 반경 하나만 살짝 조정하고 싶을 때 쓴다. 값은 컨테이너 인라인
991
3151
  * 스타일로 들어가 스타일시트를 항상 이긴다. 색·형태를 섞지 않도록 색 값을 넣으면 **throw** 한다.
992
- * / Override a single form-axis CSS variable at runtime — the form-axis sibling of `setThemeVar`
3152
+ *
3153
+ * Override a single form-axis CSS variable at runtime — the form-axis sibling of `setThemeVar`
993
3154
  * (which changes color variables). Use it to nudge one token (e.g. a radius) without defining a whole
994
3155
  * skin. The value goes in as container-inline style, so it always beats stylesheets. To keep color and
995
3156
  * form separate, passing a color value **throws**.
996
3157
  *
997
- * @param k - CSS 변수 이름(예 '--og-radius-md') / CSS variable name (e.g. '--og-radius-md')
998
- * @param v - 형태 값(색값 넣으면 throw) / Form value (throws on a color value)
3158
+ * 形状(FORM 軸)の CSS 変数を 1 つ、ランタイムで上書きします — 色の変数を変える `setThemeVar` の、形状軸における
3159
+ * 対です。スキンを 1 つまるごと作らなくても、角丸の半径だけを少し調整したいときに使います。値はコンテナのインライン
3160
+ * スタイルとして入るため、常にスタイルシートに勝ちます。色と形状を混ぜないよう、色の値を入れると **throw** します。
3161
+ *
3162
+ * 在运行时覆盖 1 个形状(FORM 轴)的 CSS 变量 — 是改变颜色变量的 `setThemeVar` 在形状轴上的
3163
+ * 对应物。无需整个做出一个皮肤,只想稍微调整圆角半径时使用。值以容器的内联样式进入,
3164
+ * 因此总能胜过样式表。为了不把颜色与形状混在一起,放入颜色值会 **throw**。
3165
+ *
3166
+ * @param k - CSS 변수 이름(예 '--og-radius-md')
3167
+ *
3168
+ * CSS variable name (e.g. '--og-radius-md')
3169
+ *
3170
+ * CSS 変数名(例 '--og-radius-md')
3171
+ *
3172
+ * CSS 变量名(例 '--og-radius-md')
3173
+ *
3174
+ * @param v - 형태 값(색값 넣으면 throw)
3175
+ *
3176
+ * Form value (throws on a color value)
3177
+ *
3178
+ * 形状の値(色値を入れると throw)
3179
+ *
3180
+ * 形状的值(放入颜色值则 throw)
999
3181
  */
1000
3182
  setSkinVar(k: string, v: string): void;
1001
3183
  /**
@@ -1003,46 +3185,126 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
1003
3185
  * ('comfortable') 보여 줄 때 쓴다. 행 높이·안쪽 여백 토큰만 조정하는 순수 가산적 변경이라 색·형태·질감은
1004
3186
  * 전혀 건드리지 않는다. 밀도는 행 높이를 바꾸므로 좌표를 다시 계산해야 할 때 창 크기 변경과 똑같은 경로로
1005
3187
  * 재배치한다. 없는 이름을 넘겨도 안전하게 기본값으로 되돌아간다(throw 안 함).
1006
- * / Change how tightly rows are packed (density) — show the same data more compactly ('compact') or with
3188
+ *
3189
+ * Change how tightly rows are packed (density) — show the same data more compactly ('compact') or with
1007
3190
  * more breathing room ('comfortable'). It adjusts only row-height/padding tokens (purely additive), never
1008
3191
  * touching color/form/texture. Because density changes row height, it relayouts via the same path as a
1009
3192
  * window resize when needed. An unknown name safely falls back to the default (never throws).
1010
3193
  *
1011
- * @param name - 밀도 값 id(예 'compact', 'comfortable') / Density value id (e.g. 'compact')
3194
+ * 行間の詰まり具合(密度)を変えます — 同じデータを画面によりぎっしり('compact')、またはゆったり('comfortable')
3195
+ * 見せるときに使います。行の高さ・内側の余白のトークンだけを調整する純粋に加算的な変更なので、色・形状・質感には
3196
+ * いっさい触れません。密度は行の高さを変えるため、座標を計算し直す必要があるときはウィンドウのサイズ変更と同じ経路で
3197
+ * 再配置します。存在しない名前を渡しても安全に既定値へ戻ります(throw しません)。
3198
+ *
3199
+ * 改变行间的紧密程度(密度)— 想把同样的数据在画面上显示得更密('compact')或更宽松('comfortable')
3200
+ * 时使用。它只调整行高、内侧留白的 token,是纯粹加算式的变更,完全不碰颜色、形状、质感。
3201
+ * 因为密度会改变行高,需要重新计算坐标时,以与窗口尺寸变更相同的路径重新布局。
3202
+ * 传入不存在的名称也会安全地回到默认值(不会 throw)。
3203
+ *
3204
+ * @param name - 밀도 값 id(예 'compact', 'comfortable')
3205
+ *
3206
+ * Density value id (e.g. 'compact')
3207
+ *
3208
+ * 密度の値 id(例 'compact'、'comfortable')
3209
+ *
3210
+ * 密度的值 id(例 'compact'、'comfortable')
1012
3211
  */
1013
3212
  setDensity(name: string): void;
1014
3213
  /**
1015
3214
  * 배경 질감을 바꾼다 — 밋밋한 배경 대신 리넨('linen')·종이결('paper-grain')·모눈('graph') 같은 결을 깔고
1016
3215
  * 싶을 때 쓴다. 배경 페인트만 바꾸는 순수 가산적 변경이라 행 위치는 그대로다(재배치 없음). 색·형태·밀도 축과
1017
3216
  * 따로 논다. 없는 이름을 넘겨도 안전하게 기본(질감 없음)으로 되돌아간다(throw 안 함).
1018
- * / Change the background texture — lay a grain like linen ('linen'), paper ('paper-grain'), or a grid
3217
+ *
3218
+ * Change the background texture — lay a grain like linen ('linen'), paper ('paper-grain'), or a grid
1019
3219
  * ('graph') over the plain background. It only repaints the background (purely additive), so row positions
1020
3220
  * stay put (no relayout). Independent of the color/form/density axes. An unknown name safely falls back to
1021
3221
  * none (never throws).
1022
3222
  *
1023
- * @param name - 질감 값 id(예 'linen', 'paper-grain', 'graph') / Texture value id (e.g. 'linen')
3223
+ * 背景の質感を変えます — のっぺりした背景の代わりに、リネン('linen')・紙目('paper-grain')・方眼('graph')といった
3224
+ * 風合いを敷きたいときに使います。背景のペイントだけを変える純粋に加算的な変更なので、行の位置はそのままです
3225
+ * (再配置なし)。色・形状・密度の各軸とは独立しています。存在しない名前を渡しても安全に既定(質感なし)へ戻ります
3226
+ * (throw しません)。
3227
+ *
3228
+ * 改变背景的质感 — 想在平淡的背景上铺一层亚麻('linen')、纸纹('paper-grain')、方格('graph')这类
3229
+ * 纹理时使用。它只改变背景的绘制,是纯粹加算式的变更,因此行的位置保持不变(无需重新布局)。
3230
+ * 与颜色、形状、密度各轴互不相干。传入不存在的名称也会安全地回到默认(无质感)(不会 throw)。
3231
+ *
3232
+ * @param name - 질감 값 id(예 'linen', 'paper-grain', 'graph')
3233
+ *
3234
+ * Texture value id (e.g. 'linen')
3235
+ *
3236
+ * 質感の値 id(例 'linen'、'paper-grain'、'graph')
3237
+ *
3238
+ * 质感的值 id(例 'linen'、'paper-grain'、'graph')
1024
3239
  */
1025
3240
  setTexture(name: string): void;
1026
3241
  /**
1027
- * 트리거 등록('before:{op}' 취소 가능, 'after:{op}' 결과 수신). / Register a trigger
1028
- * ('before:{op}' can cancel, 'after:{op}' receives the result).
3242
+ * 트리거 등록('before:{op}' 취소 가능, 'after:{op}' 결과 수신).
3243
+ *
3244
+ * Register a trigger ('before:{op}' can cancel, 'after:{op}' receives the result).
3245
+ *
3246
+ * トリガーの登録('before:{op}' はキャンセル可能、'after:{op}' は結果を受け取ります)。
3247
+ *
3248
+ * 注册触发器('before:{op}' 可取消,'after:{op}' 接收结果)。
3249
+ *
3250
+ * @param event - 트리거 이벤트명
3251
+ *
3252
+ * Trigger event name
3253
+ *
3254
+ * トリガーのイベント名
3255
+ *
3256
+ * 触发器的事件名
3257
+ *
3258
+ * @param handler - 핸들러(ctx.cancel() 지원)
3259
+ *
3260
+ * Handler (supports ctx.cancel())
3261
+ *
3262
+ * ハンドラ(ctx.cancel() に対応)
3263
+ *
3264
+ * 处理函数(支持 ctx.cancel())
3265
+ *
3266
+ * @returns 체이닝용 this
3267
+ *
3268
+ * this for chaining
3269
+ *
3270
+ * チェーン用の this
3271
+ *
3272
+ * 用于链式调用的 this
1029
3273
  *
1030
- * @param event - 트리거 이벤트명 / Trigger event name
1031
- * @param handler - 핸들러(ctx.cancel() 지원) / Handler (supports ctx.cancel())
1032
- * @returns 체이닝용 this / this for chaining
1033
3274
  * @example
1034
3275
  * grid.addTrigger('before:insertRow', ctx => { if (!ctx.args[0]?.name) ctx.cancel(); });
1035
3276
  */
1036
3277
  addTrigger(event: TriggerEvent | string, handler: TriggerHandler): this;
1037
- /** 트리거 제거. / Remove a trigger. */
3278
+ /**
3279
+ * 트리거 제거.
3280
+ *
3281
+ * Remove a trigger.
3282
+ *
3283
+ * トリガーの削除。
3284
+ *
3285
+ * 删除触发器。
3286
+ */
1038
3287
  removeTrigger(event: TriggerEvent | string, handler: TriggerHandler): this;
1039
- /** 트리거 전체 또는 특정 이벤트 클리어. / Clear all triggers or those of one event. */
3288
+ /**
3289
+ * 트리거 전체 또는 특정 이벤트 클리어.
3290
+ *
3291
+ * Clear all triggers or those of one event.
3292
+ *
3293
+ * トリガー全体、または特定イベントのトリガーのクリア。
3294
+ *
3295
+ * 清除触发器的全体,或特定事件的触发器。
3296
+ */
1040
3297
  clearTriggers(event?: TriggerEvent | string): this;
1041
3298
  private _mkCtx;
1042
3299
  private _trig;
1043
3300
  /**
1044
3301
  * 그리드를 파괴한다(옵저버/이벤트/차트/패널 해제, DOM 정리, override 전체 복구).
1045
- * / Destroy the grid (detach observers/events/charts/panels, clean the DOM, restore all overrides).
3302
+ *
3303
+ * Destroy the grid (detach observers/events/charts/panels, clean the DOM, restore all overrides).
3304
+ *
3305
+ * グリッドを破棄します(オブザーバ/イベント/チャート/パネルの解除、DOM の後片付け、override の全復元)。
3306
+ *
3307
+ * 销毁表格(解除观察器/事件/图表/面板,清理 DOM,恢复全部 override)。
1046
3308
  */
1047
3309
  destroy(): void;
1048
3310
  }