open-grid 1.5.2 → 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 (77) hide show
  1. package/CHANGELOG.md +475 -416
  2. package/README.ja.md +39 -0
  3. package/README.md +39 -0
  4. package/README.zh.md +39 -0
  5. package/dist/{OpenGrid-CT9bV6On.cjs → OpenGrid-CLk8Vt7j.cjs} +1390 -1316
  6. package/dist/{OpenGrid-DACnZdEy.js → OpenGrid-D6YxCsnV.js} +1757 -1683
  7. package/dist/angular/fesm2022/open-grid-angular.mjs +247 -0
  8. package/dist/angular/index.d.ts +5 -0
  9. package/dist/angular/lib/open-grid.component.d.ts +97 -0
  10. package/dist/angular/public-api.d.ts +6 -0
  11. package/dist/{index-Brfso4Ry.cjs → index-D0DJtKYI.cjs} +2 -2
  12. package/dist/{index-al9Mbv3E.js → index-VkKgQ506.js} +2 -2
  13. package/dist/open-grid-a11y.cjs +216 -0
  14. package/dist/open-grid-a11y.js +219 -0
  15. package/dist/open-grid-base.css +13 -4
  16. package/dist/open-grid-header.cjs +4 -4
  17. package/dist/open-grid-header.css +18 -27
  18. package/dist/open-grid-header.js +4 -4
  19. package/dist/open-grid-react.cjs +1 -1
  20. package/dist/open-grid-react.js +1 -1
  21. package/dist/open-grid-skins.css +2 -2
  22. package/dist/open-grid-themes.css +19 -19
  23. package/dist/open-grid-typography.cjs +2 -2
  24. package/dist/open-grid-typography.js +2 -2
  25. package/dist/open-grid-vue.cjs +1 -1
  26. package/dist/open-grid-vue.js +1 -1
  27. package/dist/open-grid.cjs +5 -2
  28. package/dist/open-grid.js +6 -3
  29. package/dist/types/a11y/index.d.ts +37 -0
  30. package/dist/types/core/ColumnLayout.d.ts +3 -3
  31. package/dist/types/core/DetailManager.d.ts +1 -1
  32. package/dist/types/core/ExportManager.d.ts +9 -6
  33. package/dist/types/core/ExtensionPointRegistry.d.ts +2 -2
  34. package/dist/types/core/FlatRowModel.d.ts +8 -0
  35. package/dist/types/core/MergeEngine.d.ts +45 -5
  36. package/dist/types/core/MutationService.d.ts +4 -9
  37. package/dist/types/core/OpenGrid.d.ts +357 -16
  38. package/dist/types/core/OrgChart.d.ts +24 -0
  39. package/dist/types/core/RowDragDrop.d.ts +2 -0
  40. package/dist/types/core/SortFilterManager.d.ts +8 -0
  41. package/dist/types/core/WorksheetManager.d.ts +2 -2
  42. package/dist/types/core/a11y/KeyboardInteractionModel.d.ts +321 -20
  43. package/dist/types/core/a11y/LiveRegionController.d.ts +229 -27
  44. package/dist/types/core/a11y/VisualEquivRegistry.d.ts +199 -14
  45. package/dist/types/core/appearance/AppearanceAxis.d.ts +54 -6
  46. package/dist/types/core/appearance/HeaderRegistry.d.ts +213 -21
  47. package/dist/types/core/appearance/TextureRegistry.d.ts +10 -0
  48. package/dist/types/core/appearance/TypographyRegistry.d.ts +63 -3
  49. package/dist/types/core/cf/CFRule.d.ts +145 -22
  50. package/dist/types/core/chart/DataExtractor.d.ts +1 -1
  51. package/dist/types/core/detail/DetailGlyph.d.ts +3 -3
  52. package/dist/types/core/types.d.ts +511 -31
  53. package/dist/types/header/index.d.ts +146 -6
  54. package/dist/types/index.d.ts +31 -1
  55. package/dist/types/typography/index.d.ts +134 -4
  56. package/dist/types/vue/OpenGrid.vue.d.ts +1 -1
  57. package/package.json +47 -13
  58. package/dist/OpenGrid-CT9bV6On.cjs.map +0 -1
  59. package/dist/OpenGrid-DACnZdEy.js.map +0 -1
  60. package/dist/Registry-CPJYOqCn.js.map +0 -1
  61. package/dist/Registry-D74ZmdDz.cjs.map +0 -1
  62. package/dist/index-Brfso4Ry.cjs.map +0 -1
  63. package/dist/index-CeJ-0-80.cjs.map +0 -1
  64. package/dist/index-DnarQ4eR.js.map +0 -1
  65. package/dist/index-al9Mbv3E.js.map +0 -1
  66. package/dist/open-grid-header.cjs.map +0 -1
  67. package/dist/open-grid-header.js.map +0 -1
  68. package/dist/open-grid-react.cjs.map +0 -1
  69. package/dist/open-grid-react.js.map +0 -1
  70. package/dist/open-grid-typography.cjs.map +0 -1
  71. package/dist/open-grid-typography.js.map +0 -1
  72. package/dist/open-grid-vue.cjs.map +0 -1
  73. package/dist/open-grid-vue.js.map +0 -1
  74. package/dist/open-grid.cjs.map +0 -1
  75. package/dist/open-grid.js.map +0 -1
  76. package/dist/xlsx.min-BQ1o3sB6.cjs.map +0 -1
  77. package/dist/xlsx.min-Bbz2ZypC.js.map +0 -1
@@ -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
  *
@@ -1034,13 +1233,17 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
1034
1233
  */
1035
1234
  getWorksheetNames(): string[];
1036
1235
  /**
1037
- * 모든 워크시트를 다중 시트 엑셀로 내보낸다.
1236
+ * 모든 워크시트를 다중 시트 엑셀로 내보낸다. 시트마다 exportExcel 과 같은 테마 스타일(머리글 배경·줄무늬·테두리·숫자 서식)을 입히고,
1237
+ * 지금 보고 있는 시트는 화면에서 고친 내용까지 담는다.
1038
1238
  *
1039
- * Export all worksheets as a multi-sheet Excel file.
1239
+ * Export all worksheets as a multi-sheet Excel file. Each sheet gets the same theme styling as exportExcel
1240
+ * (header fill, banding, borders, number formats), and the active sheet includes edits made on screen.
1040
1241
  *
1041
- * すべてのワークシートを複数シートの Excel として書き出します。
1242
+ * すべてのワークシートを複数シートの Excel として書き出します。各シートに exportExcel と同じテーマのスタイル
1243
+ * (見出しの背景・縞模様・罫線・数値書式)を付け、表示中のシートは画面で編集した内容も含めます。
1042
1244
  *
1043
- * 把所有工作表导出为多工作表的 Excel。
1245
+ * 把所有工作表导出为多工作表的 Excel。每个工作表都套用与 exportExcel 相同的主题样式(表头底色、斑马纹、边框、数字格式),
1246
+ * 当前正在查看的工作表还会包含在界面上所做的修改。
1044
1247
  */
1045
1248
  exportSheetsExcel(filename?: string): void;
1046
1249
  private _onResize;
@@ -1576,7 +1779,41 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
1576
1779
  */
1577
1780
  getRowAt(rowIndex: number): T;
1578
1781
  /**
1579
- * 화면상의 행 위치(flat/visual index)와 실제 데이터 행을 서로 변환해 주는 리졸버를 돌려준다. 그룹 머리글·
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;
1815
+ /**
1816
+ * 화면상의 행 위치(flat/visual index)와 실제 데이터 행을 서로 변환해 주는 리졸버를 돌려준다. 그룹 헤더·
1580
1817
  * 트리 자식·상세 패널 같은 의사(pseudo) 행이 섞여 index 와 데이터가 어긋날 때, "이 index 가 진짜 데이터 행인가,
1581
1818
  * 몇 번 rowId 인가"를 물어보는 단일 창구다. 범위 선택+채우기·수식·차트 기능이 좌표를 해석할 때 모두 이 모델을 거친다.
1582
1819
  *
@@ -1814,7 +2051,7 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
1814
2051
  /**
1815
2052
  * 여러 셀을 한 번에 쓴다. 내부에서 배치로 묶어 처리하므로 렌더·이벤트가 셀마다 터지지 않고 끝에서 한 번만
1816
2053
  * 일어나, 수백 셀을 갱신할 때 낱개 `writeCell` 반복보다 훨씬 빠르다. 각 rowIndex 는 화면 기준 위치(flat
1817
- * index)이며, 대상이 실제 데이터 행이 아니라 그룹 머리글·트리·상세 같은 의사(pseudo) 행이면 데이터 훼손을
2054
+ * index)이며, 대상이 실제 데이터 행이 아니라 그룹 헤더·트리·상세 같은 의사(pseudo) 행이면 데이터 훼손을
1818
2055
  * 막기 위해 그 셀은 조용히 건너뛴다. 건너뛴 셀 수를 돌려주고, 1건이라도 있으면 스크린리더 안내와
1819
2056
  * 'writeCellsSkip' 이벤트로 알린다.
1820
2057
  *
@@ -2189,7 +2426,7 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
2189
2426
  *
2190
2427
  * 把列构成的整体换成新定义并重新绘制。按画面模式整体更换要展示的列集合时使用(单个的添加/删除用 insertColumn/deleteColumn)。
2191
2428
  */
2192
- applyColumns(columns: ColumnDef<T>[]): void;
2429
+ applyColumns(columns: ColumnOrGroup<T>[]): void;
2193
2430
  /**
2194
2431
  * 컬럼 1개를 삽입한다.
2195
2432
  *
@@ -2800,10 +3037,64 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
2800
3037
  *
2801
3038
  * 打开打印用的窗口。
2802
3039
  */
2803
- print(options?: {
2804
- title?: string;
2805
- excludeFields?: string[];
2806
- }): 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;
2807
3098
  /**
2808
3099
  * 데이터 배열 변환.
2809
3100
  *
@@ -3026,9 +3317,10 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
3026
3317
  el?: boolean;
3027
3318
  }): string | SVGElement;
3028
3319
  /**
3029
- * i18n: 이 인스턴스의 UI 로케일을 전환한다. setSkin 진영 — 데이터 불변 + 크롬/가시창 부분 재렌더.
3030
- * `lang` 속성을 로케일 Intl 태그로 갱신(스크린리더 발음 전환), 상주 크롬(페이지네이션/찾기)의
3031
- * 라벨을 새로 그리고, 캐시된 필터 패널을 무효화한 뒤 헤더+가시창을 1회 재렌더한다.
3320
+ * i18n: 이 인스턴스의 UI 로케일을 전환한다. setSkin 진영 — 데이터 불변 + 표의 틀(헤더·페이지네이션·
3321
+ * 찾기 막대)과 보이는 영역만 부분 재렌더. `lang` 속성을 로케일 Intl 태그로 갱신(스크린리더 발음 전환),
3322
+ * 늘 떠 있는 페이지네이션·찾기 막대의 라벨을 새로 그리고, 캐시된 필터 패널을 무효화한 뒤
3323
+ * 헤더+보이는 영역을 1회 재렌더한다.
3032
3324
  * 미등록 로케일은 throw 하지 않고 폴백 유지(never-throw). 전환 후 `localeChange` 이벤트 발화.
3033
3325
  *
3034
3326
  * i18n: switch this instance's UI locale. setSkin camp — data-immutable + partial chrome/viewport
@@ -3185,21 +3477,29 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
3185
3477
  * ('comfortable') 보여 줄 때 쓴다. 행 높이·안쪽 여백 토큰만 조정하는 순수 가산적 변경이라 색·형태·질감은
3186
3478
  * 전혀 건드리지 않는다. 밀도는 행 높이를 바꾸므로 좌표를 다시 계산해야 할 때 창 크기 변경과 똑같은 경로로
3187
3479
  * 재배치한다. 없는 이름을 넘겨도 안전하게 기본값으로 되돌아간다(throw 안 함).
3480
+ * 보통 모드의 행 높이도 밀도 값으로 바뀌고, 기본('default')으로 돌아가면 사용자가 정한 행 높이(생성 옵션
3481
+ * `rowHeight` 또는 마지막 `setRowHeight`)로 돌아온다.
3188
3482
  *
3189
3483
  * Change how tightly rows are packed (density) — show the same data more compactly ('compact') or with
3190
3484
  * more breathing room ('comfortable'). It adjusts only row-height/padding tokens (purely additive), never
3191
3485
  * touching color/form/texture. Because density changes row height, it relayouts via the same path as a
3192
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`).
3193
3489
  *
3194
3490
  * 行間の詰まり具合(密度)を変えます — 同じデータを画面によりぎっしり('compact')、またはゆったり('comfortable')
3195
3491
  * 見せるときに使います。行の高さ・内側の余白のトークンだけを調整する純粋に加算的な変更なので、色・形状・質感には
3196
3492
  * いっさい触れません。密度は行の高さを変えるため、座標を計算し直す必要があるときはウィンドウのサイズ変更と同じ経路で
3197
3493
  * 再配置します。存在しない名前を渡しても安全に既定値へ戻ります(throw しません)。
3494
+ * 通常モードの行の高さも密度の値に変わり、既定('default')に戻ると利用者が決めた行の高さ(生成オプション
3495
+ * `rowHeight` または最後の `setRowHeight`)に戻ります。
3198
3496
  *
3199
3497
  * 改变行间的紧密程度(密度)— 想把同样的数据在画面上显示得更密('compact')或更宽松('comfortable')
3200
3498
  * 时使用。它只调整行高、内侧留白的 token,是纯粹加算式的变更,完全不碰颜色、形状、质感。
3201
3499
  * 因为密度会改变行高,需要重新计算坐标时,以与窗口尺寸变更相同的路径重新布局。
3202
3500
  * 传入不存在的名称也会安全地回到默认值(不会 throw)。
3501
+ * 普通模式的行高也会随密度改变;回到默认('default')时恢复为用户设定的行高(创建选项 `rowHeight`
3502
+ * 或最后一次 `setRowHeight`)。
3203
3503
  *
3204
3504
  * @param name - 밀도 값 id(예 'compact', 'comfortable')
3205
3505
  *
@@ -3210,24 +3510,65 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
3210
3510
  * 密度的值 id(例 'compact'、'comfortable')
3211
3511
  */
3212
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;
3213
3547
  /**
3214
3548
  * 배경 질감을 바꾼다 — 밋밋한 배경 대신 리넨('linen')·종이결('paper-grain')·모눈('graph') 같은 결을 깔고
3215
3549
  * 싶을 때 쓴다. 배경 페인트만 바꾸는 순수 가산적 변경이라 행 위치는 그대로다(재배치 없음). 색·형태·밀도 축과
3216
3550
  * 따로 논다. 없는 이름을 넘겨도 안전하게 기본(질감 없음)으로 되돌아간다(throw 안 함).
3551
+ * 결은 머리글·바닥글·페이지 바에만 깔리고 데이터 칸 뒤에는 깔리지 않는다. 테마가 머리글에 깐 무늬가 있으면
3552
+ * 질감이 우선한다(색은 그대로).
3217
3553
  *
3218
3554
  * Change the background texture — lay a grain like linen ('linen'), paper ('paper-grain'), or a grid
3219
3555
  * ('graph') over the plain background. It only repaints the background (purely additive), so row positions
3220
3556
  * stay put (no relayout). Independent of the color/form/density axes. An unknown name safely falls back to
3221
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).
3222
3560
  *
3223
3561
  * 背景の質感を変えます — のっぺりした背景の代わりに、リネン('linen')・紙目('paper-grain')・方眼('graph')といった
3224
3562
  * 風合いを敷きたいときに使います。背景のペイントだけを変える純粋に加算的な変更なので、行の位置はそのままです
3225
3563
  * (再配置なし)。色・形状・密度の各軸とは独立しています。存在しない名前を渡しても安全に既定(質感なし)へ戻ります
3226
3564
  * (throw しません)。
3565
+ * 風合いは見出し・フッター・ページバーにだけ敷かれ、データのセルの後ろには敷かれません。テーマが見出しに
3566
+ * 模様を敷いている場合は質感が優先されます(色はそのまま)。
3227
3567
  *
3228
3568
  * 改变背景的质感 — 想在平淡的背景上铺一层亚麻('linen')、纸纹('paper-grain')、方格('graph')这类
3229
3569
  * 纹理时使用。它只改变背景的绘制,是纯粹加算式的变更,因此行的位置保持不变(无需重新布局)。
3230
3570
  * 与颜色、形状、密度各轴互不相干。传入不存在的名称也会安全地回到默认(无质感)(不会 throw)。
3571
+ * 纹理只铺在表头、表尾和分页栏上,不会铺在数据单元格后面。如果主题在表头铺了图案,质感优先(颜色不变)。
3231
3572
  *
3232
3573
  * @param name - 질감 값 id(예 'linen', 'paper-grain', 'graph')
3233
3574
  *
@@ -212,6 +212,7 @@ export declare class OrgChart {
212
212
  private _roots;
213
213
  private _expandedKeys;
214
214
  private _selectedId;
215
+ private _destroyed;
215
216
  /**
216
217
  * @param selector - 마운트할 컨테이너 셀렉터 문자열 또는 엘리먼트
217
218
  *
@@ -322,6 +323,29 @@ export declare class OrgChart {
322
323
  * 折叠所有节点(仅显示根节点)。初次打开较大的组织架构图,想先展示最上层结构时调用。
323
324
  */
324
325
  collapseAll(): void;
326
+ /**
327
+ * 조직도를 파괴한다: 컨테이너 내용을 비우고 `og-orgchart` 클래스를 떼며, 붙들던 데이터를 놓는다.
328
+ * 같은 요소를 다른 화면(그리드 등)에 다시 쓰기 전에 부른다. 두 번 불러도 탈 없다.
329
+ * `setTheme`/`setSkin` 으로 건 속성은 사용자가 정한 것이라 남긴다(`OpenGrid.destroy()` 와 같은 방침).
330
+ *
331
+ * Destroys the org chart: empties the container, removes the `og-orgchart` class and releases the
332
+ * data it held. Call it before reusing the same element for another view (a grid, etc.). Safe to
333
+ * call more than once. Attributes set through `setTheme`/`setSkin` are the caller's choice and are
334
+ * left in place (same policy as `OpenGrid.destroy()`).
335
+ *
336
+ * 組織図を破棄します: コンテナの中身を空にし、`og-orgchart` クラスを外し、保持していたデータを手放します。
337
+ * 同じ要素を別の画面(グリッドなど)に使い直す前に呼びます。何度呼んでも問題ありません。
338
+ * `setTheme`/`setSkin` で付けた属性は利用者が決めたものなので残します(`OpenGrid.destroy()` と同じ方針)。
339
+ *
340
+ * 销毁组织架构图: 清空容器内容、去掉 `og-orgchart` 类,并释放它持有的数据。
341
+ * 在把同一个元素改用于别的画面(表格等)之前调用。多次调用也没问题。
342
+ * 通过 `setTheme`/`setSkin` 设置的属性是使用者的选择,因此保留(与 `OpenGrid.destroy()` 的方针相同)。
343
+ *
344
+ * @example
345
+ * chart.destroy();
346
+ * const grid = new OpenGrid(sameElement, { columns });
347
+ */
348
+ destroy(): void;
325
349
  private _toggle;
326
350
  private _rebuild;
327
351
  private _calcLayout;
@@ -66,6 +66,8 @@ export declare class RowDragDrop {
66
66
  constructor(_bodyEl: HTMLElement, _rowHeight: number, _onDrop: RowDropCallback, _cross?: CrossGridConfig | null,
67
67
  /** fromIndex 기준 함께 드래그할 행 수(멀티행 배지용). 기본 1 / Rows dragged together from fromIndex (multi-row badge). Default 1 */
68
68
  _getDragCount?: (fromIndex: number) => number);
69
+ /** 행 높이가 바뀌면(밀도·setRowHeight) 끌어 놓을 자리 계산도 새 높이를 쓰게 한다. / Use the new row height for drop-slot math after a row-height change. */
70
+ setRowHeight(px: number): void;
69
71
  /**
70
72
  * 행 엘리먼트에 드래그 핸들 삽입.
71
73
  * / Insert a drag handle into a row element.
@@ -77,6 +77,14 @@ export declare class SortFilterManager<T extends Record<string, any> = any> {
77
77
  * mgr.sort([{ field: 'age', dir: 'asc' }]);
78
78
  */
79
79
  sort(fieldOrList: string | SortItem[], dir?: 'asc' | 'desc'): void;
80
+ /**
81
+ * `sortChange` 를 모든 길에서 같은 모양으로 낸다: `field` = 방금 바뀐 컬럼, `dir` = 그 컬럼의 새 방향
82
+ * (그 컬럼 정렬이 풀렸으면 없음), `sortList` = 전체 정렬 목록. 바뀐 컬럼이 없으면(전체 해제) `sortList` 만.
83
+ * / Emits `sortChange` in one shape on every path: `field` = the column just changed, `dir` = its new
84
+ * direction (absent when that column's sort was cleared), `sortList` = the whole list; only `sortList`
85
+ * when no single column changed (everything cleared).
86
+ */
87
+ private _emitSortChange;
80
88
  /** 모든 정렬을 해제한다. / Clear all sorting. */
81
89
  resetSort(): void;
82
90
  /**
@@ -1,4 +1,4 @@
1
- import { ColumnDef, WorksheetState } from './types.js';
1
+ import { ColumnOrGroup, WorksheetState } from './types.js';
2
2
  /** 시트 전환 시 호출되는 콜백. / Callback invoked when the active sheet switches. */
3
3
  export type SwitchCallback<T> = (name: string, state: WorksheetState<T>) => void;
4
4
  /** i18n: 탭 UI aria 해석기(주입 없으면 전역 t). / i18n: tab-UI aria resolver (global t when not injected). */
@@ -29,7 +29,7 @@ export declare class WorksheetManager<T extends Record<string, any> = any> {
29
29
  * @param columns - 시트 컬럼 정의(기본 빈 배열) / Sheet column definitions (default empty array)
30
30
  * @param data - 시트 초기 데이터(기본 빈 배열) / Initial sheet data (default empty array)
31
31
  */
32
- add(name: string, columns?: ColumnDef<T>[], data?: T[]): void;
32
+ add(name: string, columns?: ColumnOrGroup<T>[], data?: T[]): void;
33
33
  /**
34
34
  * 시트를 제거한다. / Remove a sheet.
35
35
  *