open-grid 1.6.0 → 1.6.1

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.
Files changed (35) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/dist/{OpenGrid-DgZtbVD0.cjs → OpenGrid-CLk8Vt7j.cjs} +1177 -1108
  3. package/dist/{OpenGrid-E11B7Xa7.js → OpenGrid-D6YxCsnV.js} +1551 -1482
  4. package/dist/{index-B_e5BXnW.cjs → index-D0DJtKYI.cjs} +2 -2
  5. package/dist/{index-Brnev66-.js → index-VkKgQ506.js} +2 -2
  6. package/dist/open-grid-a11y.cjs +216 -0
  7. package/dist/open-grid-a11y.js +219 -0
  8. package/dist/open-grid-base.css +9 -0
  9. package/dist/open-grid-header.css +6 -15
  10. package/dist/open-grid-react.cjs +1 -1
  11. package/dist/open-grid-react.js +1 -1
  12. package/dist/open-grid-vue.cjs +1 -1
  13. package/dist/open-grid-vue.js +1 -1
  14. package/dist/open-grid.cjs +5 -2
  15. package/dist/open-grid.js +6 -3
  16. package/dist/types/a11y/index.d.ts +37 -0
  17. package/dist/types/core/ColumnLayout.d.ts +3 -3
  18. package/dist/types/core/ExportManager.d.ts +2 -6
  19. package/dist/types/core/FlatRowModel.d.ts +8 -0
  20. package/dist/types/core/MergeEngine.d.ts +45 -5
  21. package/dist/types/core/MutationService.d.ts +4 -9
  22. package/dist/types/core/OpenGrid.d.ts +343 -7
  23. package/dist/types/core/OrgChart.d.ts +24 -0
  24. package/dist/types/core/RowDragDrop.d.ts +2 -0
  25. package/dist/types/core/SortFilterManager.d.ts +8 -0
  26. package/dist/types/core/WorksheetManager.d.ts +2 -2
  27. package/dist/types/core/a11y/KeyboardInteractionModel.d.ts +321 -20
  28. package/dist/types/core/a11y/LiveRegionController.d.ts +229 -27
  29. package/dist/types/core/a11y/VisualEquivRegistry.d.ts +199 -14
  30. package/dist/types/core/appearance/TextureRegistry.d.ts +10 -0
  31. package/dist/types/core/cf/CFRule.d.ts +145 -22
  32. package/dist/types/core/types.d.ts +502 -22
  33. package/dist/types/index.d.ts +31 -1
  34. package/dist/types/vue/OpenGrid.vue.d.ts +1 -1
  35. package/package.json +7 -2
@@ -1,4 +1,4 @@
1
- import { ColumnDef } from './types.js';
1
+ import { ColumnDef, ColumnOrGroup } from './types.js';
2
2
  /** 리프(말단) 컬럼 — 배치 계산에 필요한 인덱스·깊이 메타를 얹은 컬럼 정의. / A leaf column — a column def augmented with index/depth metadata for layout. */
3
3
  export interface FlatColumn<T = any> extends ColumnDef<T> {
4
4
  /** 좌→우 리프 컬럼 순번(0-base). / Left-to-right leaf column index (0-based). */
@@ -47,7 +47,7 @@ export declare class ColumnLayout<T = any> {
47
47
  * @param columns - 컬럼 정의 배열(그룹 헤더는 children 사용) / Column definitions (group headers use `children`)
48
48
  * @param frozenCount - 좌측 고정 컬럼 수(기본 0) / Number of left-frozen columns (default 0)
49
49
  */
50
- constructor(columns: ColumnDef<T>[], frozenCount?: number);
50
+ constructor(columns: ColumnOrGroup<T>[], frozenCount?: number);
51
51
  private _process;
52
52
  /** 전체 리프 컬럼(숨김 포함). / All leaf columns (including hidden ones). */
53
53
  get leaves(): FlatColumn<T>[];
@@ -68,7 +68,7 @@ export declare class ColumnLayout<T = any> {
68
68
  *
69
69
  * @param columns - 새 컬럼 정의 배열 / New column definitions
70
70
  */
71
- setColumns(columns: ColumnDef<T>[]): void;
71
+ setColumns(columns: ColumnOrGroup<T>[]): void;
72
72
  /**
73
73
  * 지정 field(들)의 리프 컬럼을 숨김 처리. / Hide the leaf column(s) for the given field(s).
74
74
  *
@@ -1,6 +1,6 @@
1
1
  import { ColumnLayout } from './ColumnLayout.js';
2
2
  import { WorksheetManager } from './WorksheetManager.js';
3
- import { ExportOptions } from './types.js';
3
+ import { ExportOptions, PrintOptions } from './types.js';
4
4
  /**
5
5
  * ExportManager 의존성 주입 인터페이스. / Dependency-injection interface for ExportManager.
6
6
  *
@@ -90,11 +90,7 @@ export declare class ExportManager<T extends Record<string, any> = any> {
90
90
  *
91
91
  * @param options - 제목·제외 필드·인쇄 푸터 텍스트 / Title, excluded fields, and print-footer text
92
92
  */
93
- print(options?: {
94
- title?: string;
95
- excludeFields?: string[];
96
- footerText?: string;
97
- }): void;
93
+ print(options?: PrintOptions): void;
98
94
  /**
99
95
  * 워크시트 매니저의 모든 시트를 시트별 탭으로 갖는 단일 `.xlsx` 로 내보낸다.
100
96
  * / Export every sheet from the worksheet manager into a single `.xlsx` file, one tab per sheet.
@@ -78,6 +78,14 @@ export declare class FlatRowModel {
78
78
  * @returns 행 참조 정보 / Row reference info
79
79
  */
80
80
  resolveFlatRow(flatIndex: number): FlatRowRef;
81
+ /**
82
+ * flat index 가 가리키는 데이터 행(트리 노드면 그 노드의 데이터). 그룹 머리·상세 칸·범위 밖이면 null.
83
+ * / The data row at a flat index (a tree node's data for tree rows); null for group heads, detail slots or out of range.
84
+ *
85
+ * @param flatIndex - 합성된 flat 배열의 인덱스 / Index into the composed flat array
86
+ * @returns 데이터 행 또는 null / The data row or null
87
+ */
88
+ rowAt(flatIndex: number): Record<string, any> | null;
81
89
  /**
82
90
  * rowId → 현재 flat index. 없으면 -1. / rowId → current flat index; -1 if absent.
83
91
  *
@@ -6,15 +6,55 @@
6
6
  * 2. 자동 병합 / Auto merge: 같은 필드에 같은 값이 연속되면 자동으로 rowSpan
7
7
  * / consecutive equal values in a field collapse into a rowSpan automatically
8
8
  */
9
- /** 병합 대상 셀 정의(기준 셀). / A cell to merge (the anchor cell). */
9
+ /**
10
+ * 병합할 셀 지정. `row`·`col` 이 기준 셀(왼쪽 위)이고, 거기서 아래로 `rowSpan` 칸·오른쪽으로 `colSpan` 칸을 한 칸으로 합친다.
11
+ *
12
+ * A cell to merge. `row`/`col` is the anchor (top-left) cell; from there `rowSpan` cells down and `colSpan` cells right are joined into one.
13
+ *
14
+ * 結合するセルの指定。`row`・`col` が基準セル(左上)で、そこから下へ `rowSpan` 個・右へ `colSpan` 個を一つのセルにまとめます。
15
+ *
16
+ * 要合并的单元格的指定。`row`/`col` 是基准单元格(左上),从那里向下 `rowSpan` 格、向右 `colSpan` 格合成一格。
17
+ */
10
18
  export interface MergeCell {
11
- /** 표시 행 인덱스(0-base). / Display row index (0-based). */
19
+ /**
20
+ * 표시 행 인덱스(0부터).
21
+ *
22
+ * Display row index (0-based).
23
+ *
24
+ * 表示行のインデックス(0 始まり)。
25
+ *
26
+ * 显示行的索引(从 0 开始)。
27
+ */
12
28
  row: number;
13
- /** 리프 컬럼 인덱스(0-base). / Leaf column index (0-based). */
29
+ /**
30
+ * 보이는 잎 컬럼 인덱스(0부터).
31
+ *
32
+ * Visible leaf-column index (0-based).
33
+ *
34
+ * 表示されている末端列のインデックス(0 始まり)。
35
+ *
36
+ * 可见叶子列的索引(从 0 开始)。
37
+ */
14
38
  col: number;
15
- /** 세로 병합 칸 수(1 이상, 기본 1). / Vertical span count (>=1, default 1). */
39
+ /**
40
+ * 세로로 합칠 칸 수(1 이상, 기본 1).
41
+ *
42
+ * Number of cells to join vertically (1 or more, default 1).
43
+ *
44
+ * 縦にまとめるセル数(1 以上、既定 1)。
45
+ *
46
+ * 纵向合并的格数(1 以上,默认 1)。
47
+ */
16
48
  rowSpan?: number;
17
- /** 가로 병합 칸 수(1 이상, 기본 1). / Horizontal span count (>=1, default 1). */
49
+ /**
50
+ * 가로로 합칠 칸 수(1 이상, 기본 1).
51
+ *
52
+ * Number of cells to join horizontally (1 or more, default 1).
53
+ *
54
+ * 横にまとめるセル数(1 以上、既定 1)。
55
+ *
56
+ * 横向合并的格数(1 以上,默认 1)。
57
+ */
18
58
  colSpan?: number;
19
59
  }
20
60
  /** 특정 (row,col) 셀의 병합 결과 정보. / Resolved merge info for a specific (row,col) cell. */
@@ -35,16 +35,12 @@ import { GridOptions, Position } from './types.js';
35
35
  * / `true` = emit before render (writeCell/endBatch — current order); default
36
36
  * `false` = render first (insert/delete).
37
37
  * - `emitPayload` : `emit('dataChange', …)` 페이로드 지연 평가(thunk). getData() 시점을
38
- * 현행과 동일(render 뒤 or 앞)하게 유지 + 명시 onDataChange 재호출 시 2회 평가 보존.
38
+ * 현행과 동일(render 뒤 or 앞)하게 유지. `onDataChange` 옵션은 이 emit 의 리스너로만
39
+ * 불린다(한 번) — 커밋이 옵션을 따로 부르지 않는다.
39
40
  * / Lazily-evaluated (thunk) payload for `emit('dataChange', …)`. Keeps the
40
41
  * `getData()` evaluation point identical to current behavior (before or after
41
- * render) and preserves double evaluation when `onDataChange` is explicitly
42
- * re-invoked.
43
- * - `fireOnDataChangeExplicitly` : true=`_options.onDataChange?.()` 를 **명시 재호출**(bound listener 와 합쳐 DOUBLE-fire).
44
- * row mutator=true, setData/clearData=false(bound listener 로 ONCE).
45
- * / `true` = **explicitly re-invokes** `_options.onDataChange?.()` (combined with
46
- * the bound listener, this DOUBLE-fires). Row mutators = `true`;
47
- * setData/clearData = `false` (bound listener fires ONCE).
42
+ * render). The `onDataChange` option is invoked only as a listener of this emit
43
+ * (once) — the commit never calls the option separately.
48
44
  * - `flushFormula` : true=emit 전에 `_flushFormulaRecalc()`(writeCell/endBatch).
49
45
  * / `true` = calls `_flushFormulaRecalc()` right before emit (writeCell/endBatch).
50
46
  * - `preRender` : render 직전 훅(deleteRow 의 removedRowId invalidate 루프).
@@ -64,7 +60,6 @@ export interface CommitSpec {
64
60
  renderMode: 'sync-window' | 'full' | 'async-vs';
65
61
  emitBeforeRender?: boolean;
66
62
  emitPayload: () => any;
67
- fireOnDataChangeExplicitly?: boolean;
68
63
  flushFormula?: boolean;
69
64
  preRender?: () => void;
70
65
  coalescable?: boolean;
@@ -1,6 +1,6 @@
1
1
  import { EventEmitter } from './EventEmitter.js';
2
2
  import { PartialLocaleMessages, LocaleMessageKey, MessageValue } from './i18n/types.js';
3
- import { SkinTokenDelta, GridOptions, OpenGridInstance, ColumnDef, SortItem, FilterItem, ExportOptions, Position, TriggerHandler, TriggerEvent, OverrideApi, OverrideCallOptions, CellRange, RangeStats } from './types.js';
3
+ import { SkinTokenDelta, GridOptions, OpenGridInstance, ColumnDef, ColumnOrGroup, PrintOptions, GridEventMap, SortItem, FilterItem, ExportOptions, Position, TriggerHandler, TriggerEvent, OverrideApi, OverrideCallOptions, CellRange, RangeStats } from './types.js';
4
4
  import { FilterSelectConfig } from './FilterSelect.js';
5
5
  import { MergeCell } from './MergeEngine.js';
6
6
  import { RendererFactory } from './renderers/CellRenderer.js';
@@ -74,6 +74,14 @@ export interface RealtimeWireOptions {
74
74
  */
75
75
  debounceMs?: number;
76
76
  }
77
+ export interface OpenGrid<T extends Record<string, any> = any> {
78
+ on<K extends keyof GridEventMap<T>>(event: K, handler: (e: GridEventMap<T>[K]) => void): this;
79
+ on(event: string, handler: (...args: any[]) => void): this;
80
+ once<K extends keyof GridEventMap<T>>(event: K, handler: (e: GridEventMap<T>[K]) => void): this;
81
+ once(event: string, handler: (...args: any[]) => void): this;
82
+ off<K extends keyof GridEventMap<T>>(event: K, handler?: (e: GridEventMap<T>[K]) => void): this;
83
+ off(event: string, handler?: (...args: any[]) => void): this;
84
+ }
77
85
  /**
78
86
  * OPEN_GRID 코어 그리드 클래스.
79
87
  *
@@ -207,6 +215,8 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
207
215
  private _filterPanel;
208
216
  private _filterSelect;
209
217
  private _pagination;
218
+ /** 사용자가 정한 행 높이(생성 옵션 또는 마지막 setRowHeight). 기본 밀도로 돌아갈 때 쓴다. / The user's row height; restored by the default density. */
219
+ private _userRowHeight?;
210
220
  private _dnd;
211
221
  private _mergeEngine;
212
222
  private _liveRegion;
@@ -427,14 +437,199 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
427
437
  * 静态全局的 strategy 槽。
428
438
  */
429
439
  private static _defaultStrategies;
440
+ /**
441
+ * 요소 `el` 과 그 자손에 붙어 있는 그리드를 문서 순서대로 돌려준다(파괴한 그리드는 빠진다).
442
+ * 화면의 한 영역에 어떤 그리드가 떠 있는지 알아야 할 때 쓴다 — 그리드를 전역 변수에 따로 담아 둘 필요가 없다.
443
+ *
444
+ * Returns the grids mounted on element `el` and its descendants, in document order (destroyed grids
445
+ * are excluded). Use it when you need to know which grids live in an area of the page — no need to
446
+ * keep grids in global variables.
447
+ *
448
+ * 要素 `el` とその子孫に載っているグリッドを文書順に返します(破棄したグリッドは含みません)。
449
+ * 画面のある領域にどのグリッドがあるかを知りたいときに使います — グリッドをグローバル変数に別途保持する必要はありません。
450
+ *
451
+ * 按文档顺序返回挂在元素 `el` 及其后代上的表格(已销毁的表格不包含在内)。
452
+ * 需要知道页面某个区域里有哪些表格时使用 — 不必把表格另存到全局变量里。
453
+ *
454
+ * @param el - 찾을 범위의 뿌리 요소(자기 자신 포함)
455
+ *
456
+ * Root element of the search (itself included)
457
+ *
458
+ * 探す範囲のルート要素(自身を含む)
459
+ *
460
+ * 查找范围的根元素(包含其自身)
461
+ *
462
+ * @returns 살아 있는 그리드 목록
463
+ *
464
+ * The live grids
465
+ *
466
+ * 生きているグリッドの一覧
467
+ *
468
+ * 仍存活的表格列表
469
+ *
470
+ * @example
471
+ * const grids = OpenGrid.instancesIn(document.getElementById('page')!);
472
+ * console.log(`이 영역의 그리드 ${grids.length}개`);
473
+ */
474
+ static instancesIn(el: Element): OpenGrid<any>[];
475
+ /**
476
+ * 요소 `el` 과 그 자손에 붙어 있는 그리드를 모두 파괴한다. 화면의 한 영역을 갈아 끼우기 **전에** 부르면
477
+ * 그 안의 그리드가 남긴 옵저버·타이머·실시간 구독까지 정리된다(SPA 라우트 전환, 탭 닫기 등).
478
+ *
479
+ * Destroys every grid mounted on element `el` and its descendants. Call it **before** replacing an
480
+ * area of the page and the grids inside it release their observers, timers and realtime
481
+ * subscriptions too (SPA route change, closing a tab, etc.).
482
+ *
483
+ * 要素 `el` とその子孫に載っているグリッドをすべて破棄します。画面のある領域を差し替える**前に**呼ぶと、
484
+ * その中のグリッドが残したオブザーバ・タイマー・リアルタイム購読まで片付きます(SPA のルート切り替え、タブを閉じるときなど)。
485
+ *
486
+ * 销毁挂在元素 `el` 及其后代上的所有表格。在替换页面某个区域**之前**调用,
487
+ * 其中表格留下的观察器、定时器、实时订阅也会一并清理(SPA 路由切换、关闭标签页等)。
488
+ *
489
+ * 한 그리드의 `destroy()` 가 예외를 던져도 나머지는 끝까지 정리한 뒤 그 예외를 던진다(여럿이면 `errors` 에 모은 Error).
490
+ *
491
+ * Even if one grid's `destroy()` throws, the rest are still cleaned up, then that error is thrown
492
+ * (several failures become one Error carrying them in `errors`).
493
+ *
494
+ * あるグリッドの `destroy()` が例外を投げても残りは最後まで片付け、そのあとでその例外を投げます(複数なら `errors` にまとめた Error)。
495
+ *
496
+ * 即使某个表格的 `destroy()` 抛出异常,其余表格也会清理到底,之后再抛出该异常(多个时合并为带 `errors` 的 Error)。
497
+ *
498
+ * @param el - 정리할 범위의 뿌리 요소(자기 자신 포함)
499
+ *
500
+ * Root element of the area to clean up (itself included)
501
+ *
502
+ * 片付ける範囲のルート要素(自身を含む)
503
+ *
504
+ * 要清理范围的根元素(包含其自身)
505
+ *
506
+ * @example
507
+ * OpenGrid.destroyAllIn(stage);
508
+ * stage.innerHTML = nextScreenHtml;
509
+ */
510
+ static destroyAllIn(el: Element): void;
511
+ /**
512
+ * 앞으로 만들 모든 그리드에 override 레이어를 걸고, 그 등록을 되돌리는 함수를 돌려준다.
513
+ * 화면(컴포넌트)이 사라질 때 그 함수를 부르면 그 뒤에 만드는 그리드에는 더 이상 걸리지 않는다.
514
+ * 이미 만든 그리드는 그대로다 — 그 그리드에서 벗기려면 `grid.restore(name)` 이나 `destroy()` 를 쓴다.
515
+ * 체이닝이 필요하면 `OpenGrid.defaultOverride` 를 쓴다(같은 등록, 반환값만 다르다).
516
+ *
517
+ * Applies an override layer to every grid created from now on, and returns a function that undoes
518
+ * this registration. Call it when the screen (component) goes away and grids created afterwards no
519
+ * longer get the layer. Grids that already exist keep it — to remove it from such a grid use
520
+ * `grid.restore(name)` or `destroy()`. For chaining use `OpenGrid.defaultOverride` (same
521
+ * registration, different return value).
522
+ *
523
+ * これから作るすべてのグリッドに override レイヤーを掛け、その登録を取り消す関数を返します。
524
+ * 画面(コンポーネント)が消えるときにその関数を呼べば、その後に作るグリッドにはもう掛かりません。
525
+ * すでに作ったグリッドはそのままです — そのグリッドから外すには `grid.restore(name)` か `destroy()` を使います。
526
+ * チェーンが必要なら `OpenGrid.defaultOverride` を使います(同じ登録で、戻り値だけが違います)。
527
+ *
528
+ * 给此后创建的所有表格挂上 override 层,并返回一个撤销这次注册的函数。
529
+ * 画面(组件)消失时调用这个函数,之后再创建的表格就不会再挂上它。
530
+ * 已经创建的表格保持原样 — 要从那个表格上去掉,请用 `grid.restore(name)` 或 `destroy()`。
531
+ * 需要链式调用时请用 `OpenGrid.defaultOverride`(注册相同,只是返回值不同)。
532
+ *
533
+ * @param name - 대상 공개 메서드 이름
534
+ *
535
+ * Target public method name
536
+ *
537
+ * 対象となる公開メソッド名
538
+ *
539
+ * 目标公开方法名
540
+ *
541
+ * @param fn - override 레이어 함수(첫 인자 orig)
542
+ *
543
+ * Override layer function (first arg = orig)
544
+ *
545
+ * override レイヤー関数(第 1 引数が orig)
546
+ *
547
+ * override 层函数(第 1 个参数为 orig)
548
+ *
549
+ * @param opts - 재진입/에러 정책
550
+ *
551
+ * Reentrancy & error policy
552
+ *
553
+ * 再入/エラーのポリシー
554
+ *
555
+ * 重入/错误的策略
556
+ *
557
+ * @returns 이 등록 하나만 되돌리는 함수(여러 번 불러도 탈 없음)
558
+ *
559
+ * A function that undoes only this registration (safe to call more than once)
560
+ *
561
+ * この登録ひとつだけを取り消す関数(何度呼んでも問題ありません)
562
+ *
563
+ * 只撤销这一次注册的函数(多次调用也没问题)
564
+ *
565
+ * @example
566
+ * // 앱 시작 때 한 번 — 그 뒤 만드는 모든 그리드에 걸린다.
567
+ * const off = OpenGrid.addDefaultOverride('getDisplayValue', (orig, ri, field) => orig(ri, field).toUpperCase());
568
+ * // 그 규칙이 더 필요 없어질 때(마이크로프론트엔드 언마운트, 테스트 정리 등)
569
+ * off();
570
+ * // 컴포넌트 수명에 묶을 때는 그리드를 만드는 컴포넌트보다 먼저 등록돼야 한다.
571
+ * // React 는 자식 effect 가 부모보다 먼저 돌므로, 부모 useEffect 에서 등록하면 자식이 이미 만든 그리드에는 걸리지 않는다.
572
+ */
573
+ static addDefaultOverride(name: string, fn: OverrideLayer, opts?: OverrideCallOptions): () => void;
574
+ /**
575
+ * 앞으로 만들 모든 그리드에 strategy 슬롯을 걸고, 그 등록을 되돌리는 함수를 돌려준다.
576
+ * 쓰임새와 규칙은 `addDefaultOverride` 와 같다(이미 만든 그리드는 그대로).
577
+ * 체이닝이 필요하면 `OpenGrid.defaults.strategy` 를 쓴다.
578
+ *
579
+ * Applies a strategy slot to every grid created from now on, and returns a function that undoes
580
+ * this registration. Usage and rules are the same as `addDefaultOverride` (grids that already exist
581
+ * keep it). For chaining use `OpenGrid.defaults.strategy`.
582
+ *
583
+ * これから作るすべてのグリッドに strategy スロットを掛け、その登録を取り消す関数を返します。
584
+ * 使い方と規則は `addDefaultOverride` と同じです(すでに作ったグリッドはそのまま)。
585
+ * チェーンが必要なら `OpenGrid.defaults.strategy` を使います。
586
+ *
587
+ * 给此后创建的所有表格挂上 strategy 槽,并返回一个撤销这次注册的函数。
588
+ * 用法和规则与 `addDefaultOverride` 相同(已经创建的表格保持原样)。
589
+ * 需要链式调用时请用 `OpenGrid.defaults.strategy`。
590
+ *
591
+ * @param slot - strategy 슬롯 이름
592
+ *
593
+ * Strategy slot name
594
+ *
595
+ * strategy スロット名
596
+ *
597
+ * strategy 槽名
598
+ *
599
+ * @param fn - 슬롯에 꽂을 함수
600
+ *
601
+ * Function to plug into the slot
602
+ *
603
+ * スロットに差し込む関数
604
+ *
605
+ * 插入该槽的函数
606
+ *
607
+ * @returns 이 등록 하나만 되돌리는 함수(여러 번 불러도 탈 없음)
608
+ *
609
+ * A function that undoes only this registration (safe to call more than once)
610
+ *
611
+ * この登録ひとつだけを取り消す関数(何度呼んでも問題ありません)
612
+ *
613
+ * 只撤销这一次注册的函数(多次调用也没问题)
614
+ *
615
+ * @example
616
+ * const off = OpenGrid.addDefaultStrategy('displayFormatter', companyFormatter);
617
+ * // 화면을 떠날 때
618
+ * off();
619
+ */
620
+ static addDefaultStrategy(slot: string, fn: Function): () => void;
430
621
  /**
431
622
  * 정적: 모든 신규 그리드에 적용될 override 레이어 등록.
623
+ * 나중에 되돌려야 하면 되돌리는 함수를 돌려주는 `OpenGrid.addDefaultOverride` 를 쓴다.
432
624
  *
433
625
  * Static: register an override layer applied to every newly created grid.
626
+ * If you need to undo it later, use `OpenGrid.addDefaultOverride`, which returns an undo function.
434
627
  *
435
628
  * 静的: すべての新規グリッドに適用される override レイヤーを登録。
629
+ * 後で取り消す必要があれば、取り消し関数を返す `OpenGrid.addDefaultOverride` を使います。
436
630
  *
437
631
  * 静态: 注册应用到所有新建表格的 override 层。
632
+ * 之后需要撤销时,请用会返回撤销函数的 `OpenGrid.addDefaultOverride`。
438
633
  *
439
634
  * @param name - 대상 공개 메서드 이름
440
635
  *
@@ -474,12 +669,16 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
474
669
  static defaultOverride(name: string, fn: OverrideLayer, opts?: OverrideCallOptions): typeof OpenGrid;
475
670
  /**
476
671
  * 정적 전역 defaults 네임스페이스 (strategy 슬롯).
672
+ * 나중에 되돌려야 하면 되돌리는 함수를 돌려주는 `OpenGrid.addDefaultStrategy` 를 쓴다.
477
673
  *
478
674
  * Static global defaults namespace (strategy slots).
675
+ * If you need to undo it later, use `OpenGrid.addDefaultStrategy`, which returns an undo function.
479
676
  *
480
677
  * 静的グローバルな defaults 名前空間(strategy スロット)。
678
+ * 後で取り消す必要があれば、取り消し関数を返す `OpenGrid.addDefaultStrategy` を使います。
481
679
  *
482
680
  * 静态全局的 defaults 命名空间(strategy 槽)。
681
+ * 之后需要撤销时,请用会返回撤销函数的 `OpenGrid.addDefaultStrategy`。
483
682
  */
484
683
  static defaults: {
485
684
  strategy(slot: string, fn: Function): typeof OpenGrid;
@@ -982,7 +1181,7 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
982
1181
  *
983
1182
  * 工作表的数据
984
1183
  */
985
- addWorksheet(name: string, columns?: import('./types').ColumnDef<T>[], data?: T[]): void;
1184
+ addWorksheet(name: string, columns?: ColumnOrGroup<T>[], data?: T[]): void;
986
1185
  /**
987
1186
  * 워크시트를 제거한다.
988
1187
  *
@@ -1579,6 +1778,40 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
1579
1778
  * 返回指定索引的行对象(单件查询用)。
1580
1779
  */
1581
1780
  getRowAt(rowIndex: number): T;
1781
+ /**
1782
+ * 화면 순서로 늘어놓은 **전체** 목록(그룹 머리·트리·상세 칸 포함)에서 `flatIndex` 번째 줄의 데이터 행을 돌려준다. 이 번호는 스크롤 위치와 무관하다 — 지금 창에 보이는 줄 가운데 몇 번째가 아니다. 그룹 머리·상세 칸이면 `null`, 트리 줄이면 그 노드의 데이터 행.
1783
+ * `getRowAt(rowIndex)` 는 데이터의 표시 순서라 그룹·트리·상세가 켜지면 둘이 다른 줄을 가리킨다.
1784
+ *
1785
+ * Returns the data row on the `flatIndex`-th line of the **whole** list laid out in on-screen order (group heads, tree rows and detail slots included). The number does not depend on the scroll position — it is not a position among the lines currently visible in the viewport. `null` for group heads and detail slots; for tree lines, that node's data row.
1786
+ * `getRowAt(rowIndex)` uses the data's display order, so with grouping, tree or detail on the two point at different lines.
1787
+ *
1788
+ * 画面順に並べた**全体**の一覧(グループ見出し・ツリー・詳細欄を含む)で `flatIndex` 番目の行のデータ行を返します。この番号はスクロール位置と関係ありません — いま窓に見えている行の中での何番目かではありません。グループ見出し・詳細欄なら `null`、ツリーの行ならそのノードのデータ行。
1789
+ * `getRowAt(rowIndex)` はデータの表示順なので、グループ・ツリー・詳細が有効だと両者は別の行を指します。
1790
+ *
1791
+ * 在按画面顺序排列的**完整**列表(包括分组标题、树、详情栏)中,返回第 `flatIndex` 行的数据行。这个编号与滚动位置无关 — 不是当前窗口中可见行里的第几行。分组标题、详情栏返回 `null`;树的行返回该节点的数据行。
1792
+ * `getRowAt(rowIndex)` 使用数据的显示顺序,启用分组、树、详情时两者指向不同的行。
1793
+ *
1794
+ * @param flatIndex - 화면 순서 전체 목록에서의 줄 번호(0부터, 스크롤과 무관)
1795
+ *
1796
+ * Line number in the whole on-screen-order list (0-based, independent of scrolling)
1797
+ *
1798
+ * 画面順の全体一覧での行番号(0 始まり、スクロールと無関係)
1799
+ *
1800
+ * 在画面顺序完整列表中的行号(从 0 开始,与滚动无关)
1801
+ *
1802
+ * @returns 데이터 행, 없으면 `null`
1803
+ *
1804
+ * The data row, or `null`
1805
+ *
1806
+ * データ行、なければ `null`
1807
+ *
1808
+ * 数据行,没有则为 `null`
1809
+ *
1810
+ * @example
1811
+ * const row = grid.getFlatRow(3); // 전체 목록의 넷째 줄(스크롤해도 같은 줄)
1812
+ * if (row) console.log(row.name);
1813
+ */
1814
+ getFlatRow(flatIndex: number): T | null;
1582
1815
  /**
1583
1816
  * 화면상의 행 위치(flat/visual index)와 실제 데이터 행을 서로 변환해 주는 리졸버를 돌려준다. 그룹 헤더·
1584
1817
  * 트리 자식·상세 패널 같은 의사(pseudo) 행이 섞여 index 와 데이터가 어긋날 때, "이 index 가 진짜 데이터 행인가,
@@ -2193,7 +2426,7 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
2193
2426
  *
2194
2427
  * 把列构成的整体换成新定义并重新绘制。按画面模式整体更换要展示的列集合时使用(单个的添加/删除用 insertColumn/deleteColumn)。
2195
2428
  */
2196
- applyColumns(columns: ColumnDef<T>[]): void;
2429
+ applyColumns(columns: ColumnOrGroup<T>[]): void;
2197
2430
  /**
2198
2431
  * 컬럼 1개를 삽입한다.
2199
2432
  *
@@ -2804,10 +3037,64 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
2804
3037
  *
2805
3038
  * 打开打印用的窗口。
2806
3039
  */
2807
- print(options?: {
2808
- title?: string;
2809
- excludeFields?: string[];
2810
- }): void;
3040
+ print(options?: PrintOptions): void;
3041
+ /**
3042
+ * 페이지당 행 수를 바꾸고 1쪽으로 돌아간다(`pagination: true` 일 때). 페이지 바의 행 수 목록을 고른 것과 같다.
3043
+ * 페이징을 켜지 않은 그리드에서는 화면은 그대로이고 값만 기억해 두었다가 페이징을 켤 때 쓴다.
3044
+ *
3045
+ * Changes the rows per page and returns to page 1 (when `pagination: true`) — the same as picking a
3046
+ * size in the pager's rows-per-page list. On a grid without pagination nothing changes on screen; the
3047
+ * value is remembered and used when pagination is turned on.
3048
+ *
3049
+ * 1 ページあたりの行数を変えて 1 ページ目に戻ります(`pagination: true` のとき)。ページバーの行数リストで選ぶのと同じです。
3050
+ * ページングを有効にしていないグリッドでは画面は変わらず、値だけを覚えておいてページングを有効にしたときに使います。
3051
+ *
3052
+ * 修改每页行数并回到第 1 页(`pagination: true` 时)。与在分页栏的行数列表中选择相同。
3053
+ * 没有启用分页的表格上画面不变,只记住这个值,在启用分页时使用。
3054
+ *
3055
+ * @param size - 페이지당 행 수(1 이상의 정수)
3056
+ *
3057
+ * Rows per page (an integer of 1 or more)
3058
+ *
3059
+ * 1 ページあたりの行数(1 以上の整数)
3060
+ *
3061
+ * 每页行数(1 以上的整数)
3062
+ *
3063
+ * @throws RangeError — `size` 가 1 이상의 정수가 아닐 때
3064
+ *
3065
+ * RangeError — when `size` is not an integer of 1 or more
3066
+ *
3067
+ * RangeError — `size` が 1 以上の整数でないとき
3068
+ *
3069
+ * RangeError — `size` 不是 1 以上的整数时
3070
+ *
3071
+ * @example
3072
+ * grid.setPageSize(50);
3073
+ */
3074
+ setPageSize(size: number): void;
3075
+ /**
3076
+ * 찾기 바를 열고 입력 칸에 포커스한다(Ctrl+F 와 같다). 단추로 찾기를 열게 할 때 쓴다.
3077
+ *
3078
+ * Opens the find bar and focuses its input (same as Ctrl+F). Use it to open search from a button.
3079
+ *
3080
+ * 検索バーを開いて入力欄にフォーカスします(Ctrl+F と同じ)。ボタンから検索を開かせたいときに使います。
3081
+ *
3082
+ * 打开查找栏并让输入框获得焦点(与 Ctrl+F 相同)。想用按钮打开查找时使用。
3083
+ *
3084
+ * @example
3085
+ * searchButton.addEventListener('click', () => grid.openFindBar());
3086
+ */
3087
+ openFindBar(): void;
3088
+ /**
3089
+ * 찾기 바를 닫고 찾기로 걸러 낸 것을 푼다(모든 행이 다시 보인다).
3090
+ *
3091
+ * Closes the find bar and clears the find filter (all rows show again).
3092
+ *
3093
+ * 検索バーを閉じ、検索での絞り込みを解除します(すべての行が再び表示されます)。
3094
+ *
3095
+ * 关闭查找栏并解除查找的筛选(所有行重新显示)。
3096
+ */
3097
+ closeFindBar(): void;
2811
3098
  /**
2812
3099
  * 데이터 배열 변환.
2813
3100
  *
@@ -3190,21 +3477,29 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
3190
3477
  * ('comfortable') 보여 줄 때 쓴다. 행 높이·안쪽 여백 토큰만 조정하는 순수 가산적 변경이라 색·형태·질감은
3191
3478
  * 전혀 건드리지 않는다. 밀도는 행 높이를 바꾸므로 좌표를 다시 계산해야 할 때 창 크기 변경과 똑같은 경로로
3192
3479
  * 재배치한다. 없는 이름을 넘겨도 안전하게 기본값으로 되돌아간다(throw 안 함).
3480
+ * 보통 모드의 행 높이도 밀도 값으로 바뀌고, 기본('default')으로 돌아가면 사용자가 정한 행 높이(생성 옵션
3481
+ * `rowHeight` 또는 마지막 `setRowHeight`)로 돌아온다.
3193
3482
  *
3194
3483
  * Change how tightly rows are packed (density) — show the same data more compactly ('compact') or with
3195
3484
  * more breathing room ('comfortable'). It adjusts only row-height/padding tokens (purely additive), never
3196
3485
  * touching color/form/texture. Because density changes row height, it relayouts via the same path as a
3197
3486
  * window resize when needed. An unknown name safely falls back to the default (never throws).
3487
+ * The normal-mode row height follows the density too; back at 'default' it returns to the user's row
3488
+ * height (the `rowHeight` option or the last `setRowHeight`).
3198
3489
  *
3199
3490
  * 行間の詰まり具合(密度)を変えます — 同じデータを画面によりぎっしり('compact')、またはゆったり('comfortable')
3200
3491
  * 見せるときに使います。行の高さ・内側の余白のトークンだけを調整する純粋に加算的な変更なので、色・形状・質感には
3201
3492
  * いっさい触れません。密度は行の高さを変えるため、座標を計算し直す必要があるときはウィンドウのサイズ変更と同じ経路で
3202
3493
  * 再配置します。存在しない名前を渡しても安全に既定値へ戻ります(throw しません)。
3494
+ * 通常モードの行の高さも密度の値に変わり、既定('default')に戻ると利用者が決めた行の高さ(生成オプション
3495
+ * `rowHeight` または最後の `setRowHeight`)に戻ります。
3203
3496
  *
3204
3497
  * 改变行间的紧密程度(密度)— 想把同样的数据在画面上显示得更密('compact')或更宽松('comfortable')
3205
3498
  * 时使用。它只调整行高、内侧留白的 token,是纯粹加算式的变更,完全不碰颜色、形状、质感。
3206
3499
  * 因为密度会改变行高,需要重新计算坐标时,以与窗口尺寸变更相同的路径重新布局。
3207
3500
  * 传入不存在的名称也会安全地回到默认值(不会 throw)。
3501
+ * 普通模式的行高也会随密度改变;回到默认('default')时恢复为用户设定的行高(创建选项 `rowHeight`
3502
+ * 或最后一次 `setRowHeight`)。
3208
3503
  *
3209
3504
  * @param name - 밀도 값 id(예 'compact', 'comfortable')
3210
3505
  *
@@ -3215,24 +3510,65 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
3215
3510
  * 密度的值 id(例 'compact'、'comfortable')
3216
3511
  */
3217
3512
  setDensity(name: string): void;
3513
+ /**
3514
+ * 보통 모드의 행 높이(px)를 바꾸고 다시 배치한다. 이 값은 「사용자가 정한 행 높이」로 기억되어, 밀도를 기본(`setDensity('default')`)으로 되돌릴 때도 이 값으로 돌아온다.
3515
+ * 밀도 프리셋 대신 딱 맞는 높이가 필요할 때 쓴다.
3516
+ *
3517
+ * Changes the normal-mode row height (px) and lays out again. The value is remembered as "the user's row height", so returning the density to default (`setDensity('default')`) also comes back to it.
3518
+ * Use it when you need an exact height instead of a density preset.
3519
+ *
3520
+ * 通常モードの行の高さ(px)を変えて配置し直します。この値は「利用者が決めた行の高さ」として覚えられ、密度を既定(`setDensity('default')`)に戻したときもこの値に戻ります。
3521
+ * 密度のプリセットではなく、ぴったりの高さが必要なときに使います。
3522
+ *
3523
+ * 修改普通模式的行高(px)并重新布局。这个值会被记为「用户设定的行高」,把密度恢复为默认(`setDensity('default')`)时也会回到这个值。
3524
+ * 需要精确高度而不是密度预设时使用。
3525
+ *
3526
+ * @param px - 행 높이(1 이상의 유한수)
3527
+ *
3528
+ * Row height (a finite number of 1 or more)
3529
+ *
3530
+ * 行の高さ(1 以上の有限の数)
3531
+ *
3532
+ * 行高(1 以上的有限数)
3533
+ *
3534
+ * @throws RangeError — `px` 가 1 이상의 유한수가 아닐 때
3535
+ *
3536
+ * RangeError — when `px` is not a finite number of 1 or more
3537
+ *
3538
+ * RangeError — `px` が 1 以上の有限の数でないとき
3539
+ *
3540
+ * RangeError — `px` 不是 1 以上的有限数时
3541
+ *
3542
+ * @example
3543
+ * grid.setRowHeight(44); // 터치 화면에서 손가락으로 누르기 좋게
3544
+ */
3545
+ setRowHeight(px: number): void;
3546
+ private _applyRowHeight;
3218
3547
  /**
3219
3548
  * 배경 질감을 바꾼다 — 밋밋한 배경 대신 리넨('linen')·종이결('paper-grain')·모눈('graph') 같은 결을 깔고
3220
3549
  * 싶을 때 쓴다. 배경 페인트만 바꾸는 순수 가산적 변경이라 행 위치는 그대로다(재배치 없음). 색·형태·밀도 축과
3221
3550
  * 따로 논다. 없는 이름을 넘겨도 안전하게 기본(질감 없음)으로 되돌아간다(throw 안 함).
3551
+ * 결은 머리글·바닥글·페이지 바에만 깔리고 데이터 칸 뒤에는 깔리지 않는다. 테마가 머리글에 깐 무늬가 있으면
3552
+ * 질감이 우선한다(색은 그대로).
3222
3553
  *
3223
3554
  * Change the background texture — lay a grain like linen ('linen'), paper ('paper-grain'), or a grid
3224
3555
  * ('graph') over the plain background. It only repaints the background (purely additive), so row positions
3225
3556
  * stay put (no relayout). Independent of the color/form/density axes. An unknown name safely falls back to
3226
3557
  * none (never throws).
3558
+ * The grain goes on the header, footer and pager only, never behind data cells. If the theme draws a
3559
+ * pattern on the header, the texture takes precedence (colors stay the same).
3227
3560
  *
3228
3561
  * 背景の質感を変えます — のっぺりした背景の代わりに、リネン('linen')・紙目('paper-grain')・方眼('graph')といった
3229
3562
  * 風合いを敷きたいときに使います。背景のペイントだけを変える純粋に加算的な変更なので、行の位置はそのままです
3230
3563
  * (再配置なし)。色・形状・密度の各軸とは独立しています。存在しない名前を渡しても安全に既定(質感なし)へ戻ります
3231
3564
  * (throw しません)。
3565
+ * 風合いは見出し・フッター・ページバーにだけ敷かれ、データのセルの後ろには敷かれません。テーマが見出しに
3566
+ * 模様を敷いている場合は質感が優先されます(色はそのまま)。
3232
3567
  *
3233
3568
  * 改变背景的质感 — 想在平淡的背景上铺一层亚麻('linen')、纸纹('paper-grain')、方格('graph')这类
3234
3569
  * 纹理时使用。它只改变背景的绘制,是纯粹加算式的变更,因此行的位置保持不变(无需重新布局)。
3235
3570
  * 与颜色、形状、密度各轴互不相干。传入不存在的名称也会安全地回到默认(无质感)(不会 throw)。
3571
+ * 纹理只铺在表头、表尾和分页栏上,不会铺在数据单元格后面。如果主题在表头铺了图案,质感优先(颜色不变)。
3236
3572
  *
3237
3573
  * @param name - 질감 값 id(예 'linen', 'paper-grain', 'graph')
3238
3574
  *