open-grid 1.6.0 → 1.7.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.
Files changed (126) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/dist/ExportProgressView-9Kt1SQxv.js +48 -0
  3. package/dist/ExportProgressView-B59uHIwt.cjs +48 -0
  4. package/dist/LcpMergeOrderer-BdUtV67j.js +114 -0
  5. package/dist/LcpMergeOrderer-C_ANVkGk.cjs +113 -0
  6. package/dist/OpenGrid-BUYQs1_w.cjs +9806 -0
  7. package/dist/OpenGrid-BmagF0yo.js +9819 -0
  8. package/dist/XlsxChannel-DOeHeP7h.cjs +95 -0
  9. package/dist/XlsxChannel-DdaiytFR.js +95 -0
  10. package/dist/XlsxWorkbookWriter-BTNtZ80J.js +199 -0
  11. package/dist/XlsxWorkbookWriter-_u5stfg4.cjs +198 -0
  12. package/dist/{index-Brnev66-.js → index-B9_g5Eg3.js} +2 -2
  13. package/dist/{index-B_e5BXnW.cjs → index-CnyumyPV.cjs} +2 -2
  14. package/dist/open-grid-a11y.cjs +216 -0
  15. package/dist/open-grid-a11y.js +219 -0
  16. package/dist/open-grid-base.css +9 -0
  17. package/dist/open-grid-header.css +6 -15
  18. package/dist/open-grid-react.cjs +1 -1
  19. package/dist/open-grid-react.js +1 -1
  20. package/dist/open-grid-vue.cjs +1 -1
  21. package/dist/open-grid-vue.js +1 -1
  22. package/dist/open-grid.cjs +5 -2
  23. package/dist/open-grid.js +6 -3
  24. package/dist/sinks-BWkWQexV.js +149 -0
  25. package/dist/sinks-DPK0VxYG.cjs +143 -0
  26. package/dist/types/a11y/index.d.ts +37 -0
  27. package/dist/types/core/CFRenderBridge.d.ts +5 -1
  28. package/dist/types/core/CellEditManager.d.ts +26 -2
  29. package/dist/types/core/CellEventHandler.d.ts +6 -2
  30. package/dist/types/core/ColumnLayout.d.ts +11 -3
  31. package/dist/types/core/DataLayer.d.ts +48 -1
  32. package/dist/types/core/DetailManager.d.ts +43 -2
  33. package/dist/types/core/ExportManager.d.ts +26 -6
  34. package/dist/types/core/FindBarManager.d.ts +6 -2
  35. package/dist/types/core/FlatRowModel.d.ts +69 -3
  36. package/dist/types/core/FooterManager.d.ts +43 -1
  37. package/dist/types/core/FormulaController.d.ts +4 -4
  38. package/dist/types/core/GridComposer.d.ts +11 -1
  39. package/dist/types/core/GridRenderer.d.ts +84 -19
  40. package/dist/types/core/GroupTreeManager.d.ts +6 -4
  41. package/dist/types/core/KeyboardManager.d.ts +3 -2
  42. package/dist/types/core/MergeEngine.d.ts +45 -5
  43. package/dist/types/core/MutationService.d.ts +14 -17
  44. package/dist/types/core/OpenGrid.d.ts +350 -12
  45. package/dist/types/core/OrgChart.d.ts +24 -0
  46. package/dist/types/core/RangeSelectionManager.d.ts +23 -2
  47. package/dist/types/core/RenderController.d.ts +126 -8
  48. package/dist/types/core/RowDragDrop.d.ts +2 -0
  49. package/dist/types/core/SortFilterManager.d.ts +18 -2
  50. package/dist/types/core/VirtualScroll.d.ts +12 -0
  51. package/dist/types/core/WorksheetManager.d.ts +2 -2
  52. package/dist/types/core/a11y/KeyboardInteractionModel.d.ts +321 -20
  53. package/dist/types/core/a11y/LiveRegionController.d.ts +229 -27
  54. package/dist/types/core/a11y/VisualEquivRegistry.d.ts +199 -14
  55. package/dist/types/core/appearance/TextureRegistry.d.ts +10 -0
  56. package/dist/types/core/cf/CFRule.d.ts +145 -22
  57. package/dist/types/core/coordinate/CellTextPolicy.d.ts +58 -0
  58. package/dist/types/core/coordinate/ColumnGeometry.d.ts +60 -0
  59. package/dist/types/core/coordinate/ColumnWindow.d.ts +40 -0
  60. package/dist/types/core/coordinate/ColumnWindowPolicy.d.ts +89 -0
  61. package/dist/types/core/coordinate/ExtraColumns.d.ts +39 -0
  62. package/dist/types/core/coordinate/RangeRectCalculator.d.ts +35 -0
  63. package/dist/types/core/coordinate/ViewportHeightJudge.d.ts +28 -0
  64. package/dist/types/core/coordinate/geometryPorts.d.ts +250 -0
  65. package/dist/types/core/coordinate/ports.d.ts +5 -0
  66. package/dist/types/core/domain/footer/FooterValues.d.ts +50 -0
  67. package/dist/types/core/domain/footer/ports.d.ts +31 -0
  68. package/dist/types/core/domain/render/RenderPlanner.d.ts +17 -0
  69. package/dist/types/core/domain/render/RenderRequest.d.ts +91 -0
  70. package/dist/types/core/domain/render/ports.d.ts +169 -0
  71. package/dist/types/core/domain/resize/ResizeGesture.d.ts +25 -0
  72. package/dist/types/core/domain/resize/ResizeHitZone.d.ts +23 -0
  73. package/dist/types/core/domain/resize/ports.d.ts +64 -0
  74. package/dist/types/core/domain/sort/ComparisonOrderer.d.ts +11 -0
  75. package/dist/types/core/domain/sort/LcpMergeOrderer.d.ts +15 -0
  76. package/dist/types/core/domain/sort/RankIndex.d.ts +74 -0
  77. package/dist/types/core/domain/sort/SortCostEstimate.d.ts +36 -0
  78. package/dist/types/core/domain/sort/SortKeyColumn.d.ts +89 -0
  79. package/dist/types/core/domain/sort/SortKeyStore.d.ts +34 -0
  80. package/dist/types/core/domain/sort/Sorter.d.ts +54 -0
  81. package/dist/types/core/domain/sort/SyncSortRunner.d.ts +9 -0
  82. package/dist/types/core/domain/sort/commonPrefix.d.ts +5 -0
  83. package/dist/types/core/domain/sort/ports.d.ts +140 -0
  84. package/dist/types/core/export/ExportProgressView.d.ts +28 -0
  85. package/dist/types/core/export/channels/XlsxChannel.d.ts +29 -0
  86. package/dist/types/core/export/channels/XlsxWorkbookWriter.d.ts +17 -0
  87. package/dist/types/core/export/index.d.ts +2 -0
  88. package/dist/types/core/export/sinks.d.ts +81 -0
  89. package/dist/types/core/host/archCheck.d.ts +16 -1
  90. package/dist/types/core/i18n/locales/en.d.ts +6 -0
  91. package/dist/types/core/i18n/locales/ko.d.ts +6 -0
  92. package/dist/types/core/i18n/types.d.ts +8 -0
  93. package/dist/types/core/render/FooterView.d.ts +121 -0
  94. package/dist/types/core/render/GeometryApplier.d.ts +55 -0
  95. package/dist/types/core/render/HorizontalReveal.d.ts +26 -0
  96. package/dist/types/core/render/RangeOverlayAdapter.d.ts +10 -0
  97. package/dist/types/core/render/RenderScheduler.d.ts +225 -0
  98. package/dist/types/core/render/ResizeSinkAdapter.d.ts +35 -0
  99. package/dist/types/core/render/ScrollFollower.d.ts +34 -0
  100. package/dist/types/core/render/ScrollObserver.d.ts +47 -0
  101. package/dist/types/core/render/ScrollbarGutter.d.ts +19 -0
  102. package/dist/types/core/render/body/BodyEventRouter.d.ts +58 -0
  103. package/dist/types/core/render/body/BodyRowSet.d.ts +28 -0
  104. package/dist/types/core/render/body/BodyView.d.ts +185 -0
  105. package/dist/types/core/render/body/CellLocator.d.ts +36 -0
  106. package/dist/types/core/render/body/CellRegistry.d.ts +24 -0
  107. package/dist/types/core/render/body/ColumnPaintPlan.d.ts +19 -0
  108. package/dist/types/core/render/body/ExtraCellPainters.d.ts +20 -0
  109. package/dist/types/core/render/body/rows/BodyRowContext.d.ts +138 -0
  110. package/dist/types/core/render/body/rows/DataRowPainter.d.ts +58 -0
  111. package/dist/types/core/render/body/rows/DetailRowPainter.d.ts +24 -0
  112. package/dist/types/core/render/body/rows/GroupRowPainter.d.ts +32 -0
  113. package/dist/types/core/render/body/rows/RowPainterTable.d.ts +24 -0
  114. package/dist/types/core/render/body/rows/WindowLayout.d.ts +38 -0
  115. package/dist/types/core/render/dom.d.ts +10 -0
  116. package/dist/types/core/render/header/HeaderSortIndicator.d.ts +39 -0
  117. package/dist/types/core/render/header/HeaderView.d.ts +84 -0
  118. package/dist/types/core/render/header/ResizeHandleBinder.d.ts +110 -0
  119. package/dist/types/core/render/ports.d.ts +218 -0
  120. package/dist/types/core/renderers/CellRenderer.d.ts +7 -0
  121. package/dist/types/core/types.d.ts +572 -22
  122. package/dist/types/index.d.ts +31 -1
  123. package/dist/types/vue/OpenGrid.vue.d.ts +2 -2
  124. package/package.json +8 -9
  125. package/dist/OpenGrid-DgZtbVD0.cjs +0 -7390
  126. package/dist/OpenGrid-E11B7Xa7.js +0 -7403
@@ -1,6 +1,23 @@
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
+ import { IArtifactSource, IByteSink, ExportRunCtx, ExportResult } from './export/types.js';
5
+ /** 스트리밍 경로가 지연 로드하는 모듈 묶음(시험에서 교체 가능). / Lazily-loaded modules of the streaming path (swappable in tests). */
6
+ export interface StreamModules {
7
+ pickExcelSink: (o: {
8
+ fileName?: string;
9
+ fsAccess?: 'auto' | 'off';
10
+ }) => {
11
+ kind: 'fs' | 'blob';
12
+ create(): Promise<IByteSink>;
13
+ };
14
+ createChannel: (o: {
15
+ sheetName?: string;
16
+ includeHeader?: boolean;
17
+ }) => {
18
+ writeStreaming(src: IArtifactSource, sink: IByteSink, ctx?: ExportRunCtx): Promise<ExportResult>;
19
+ };
20
+ }
4
21
  /**
5
22
  * ExportManager 의존성 주입 인터페이스. / Dependency-injection interface for ExportManager.
6
23
  *
@@ -32,6 +49,8 @@ export interface ExportDeps<T extends Record<string, any>> {
32
49
  intlLocale: string;
33
50
  exportFont?: string;
34
51
  };
52
+ /** 스트리밍 경로 모듈 로더(미주입 시 지연 import). / Streaming module loader (lazy import when absent). */
53
+ loadStreamModules?: () => Promise<StreamModules>;
35
54
  }
36
55
  /**
37
56
  * 그리드 데이터 내보내기(Excel/CSV/JSON/인쇄) 관리자. / Manages exporting grid data (Excel/CSV/JSON/print).
@@ -68,6 +87,11 @@ export declare class ExportManager<T extends Record<string, any> = any> {
68
87
  * grid.exportExcel({ filename: 'orders', maskOnExport: true });
69
88
  */
70
89
  exportExcel(options?: ExportOptions | string): void;
90
+ /**
91
+ * @internal 대량 엑셀 스트리밍 경로: 행 청크를 흘려 쓰며 진척바·취소를 제공한다.
92
+ * / Large-export streaming path: flows row chunks, with progress bar and cancel.
93
+ */
94
+ private _exportExcelStreaming;
71
95
  /**
72
96
  * 현재 그리드 데이터를 UTF-8 BOM 포함 CSV 로 내보낸다. / Export the current grid data as a UTF-8 (BOM) CSV file.
73
97
  *
@@ -90,11 +114,7 @@ export declare class ExportManager<T extends Record<string, any> = any> {
90
114
  *
91
115
  * @param options - 제목·제외 필드·인쇄 푸터 텍스트 / Title, excluded fields, and print-footer text
92
116
  */
93
- print(options?: {
94
- title?: string;
95
- excludeFields?: string[];
96
- footerText?: string;
97
- }): void;
117
+ print(options?: PrintOptions): void;
98
118
  /**
99
119
  * 워크시트 매니저의 모든 시트를 시트별 탭으로 갖는 단일 `.xlsx` 로 내보낸다.
100
120
  * / Export every sheet from the worksheet manager into a single `.xlsx` file, one tab per sheet.
@@ -2,6 +2,7 @@ import { ColumnLayout } from './ColumnLayout.js';
2
2
  import { DataLayer } from './DataLayer.js';
3
3
  import { Pagination } from './Pagination.js';
4
4
  import { VirtualScroll } from './VirtualScroll.js';
5
+ import { IRenderRequest } from './domain/render/ports.js';
5
6
  /**
6
7
  * FindBarManager 의존성 주입 인터페이스. / Dependency-injection interface for FindBarManager.
7
8
  */
@@ -16,8 +17,11 @@ export interface FindBarDeps<T extends Record<string, any>> {
16
17
  getVs: () => VirtualScroll | null;
17
18
  /** 페이지네이션 인스턴스(행수 갱신용). 없으면 `null`. / Pagination instance (for updating row count); `null` if absent. */
18
19
  getPagination: () => Pagination | null;
19
- /** 필터 적용 후 그리드 재렌더를 트리거. / Triggers a grid re-render after the filter is applied. */
20
- doRender: () => void;
20
+ /**
21
+ * 그리기 요청을 낸다(받는 쪽이 계획대로 그린다). 이 객체는 무엇을 그릴지 정하지 않고 「무엇이 바뀌었나」만 알린다.
22
+ * / Submit a render request (the receiver paints per plan). This object reports what changed, not what to paint.
23
+ */
24
+ submitRender: (req: IRenderRequest) => void;
21
25
  /** i18n: 메시지 해석(라벨/placeholder/aria/카운트 배지). / i18n: resolve labels/placeholder/aria/count badge. */
22
26
  t: (key: string, params?: Record<string, string | number>) => string;
23
27
  }
@@ -38,11 +38,49 @@ export declare class FlatRowModel {
38
38
  private _d;
39
39
  /** group/tree 가 등록한 backing override. null 이면 plain(DataLayer.getData()). */
40
40
  private _backing;
41
- /** F2 detail splice 등록 슬롯(Phase 0: 항상 비어 있음). */
41
+ /** F2 detail splice 등록 슬롯(변환기 + 활성 술어). */
42
42
  private _splices;
43
+ /** 합성할 것이 없을 때 쓰는 원천. / Source used when there is nothing to compose. */
44
+ private readonly _direct;
45
+ /** 합성할 것이 있을 때 쓰는 원천. / Source used when there is something to compose. */
46
+ private readonly _composed;
43
47
  private _revIndex;
44
48
  private _revIndexSrc;
45
49
  constructor(deps: FlatRowModelDeps);
50
+ /**
51
+ * 진단용: 합성 없이 DataLayer 에서 바로 행을 읽은 누적 횟수. 빠른 길을 실제로 탔는지 시험이 확인하려고 둔다.
52
+ * 값의 뜻·증가 시점은 보장하지 않으며 버전 사이에 바뀔 수 있다 — 응용 코드에서 기대지 말 것.
53
+ *
54
+ * Diagnostic: cumulative count of rows read straight from DataLayer without composing, kept so tests
55
+ * can confirm the fast path is really taken. Its meaning and when it increments are not guaranteed
56
+ * and may change between versions — do not rely on it in application code.
57
+ *
58
+ * 診断用: 合成せずに DataLayer から直接行を読んだ累積回数。高速経路を実際に通ったかをテストが確かめるために置く。
59
+ * 値の意味・増える時点は保証せず、バージョン間で変わりうる — アプリケーションコードで頼らないこと。
60
+ *
61
+ * 诊断用: 不经合成、直接从 DataLayer 读取行的累计次数。用于让测试确认确实走了快速路径。
62
+ * 其含义和递增时机不作保证,版本之间可能变化 — 请勿在应用代码中依赖。
63
+ *
64
+ * @internal
65
+ */
66
+ get directHits(): number;
67
+ /**
68
+ * 내부용: 자료 계층의 구조 판 번호(행 집합·표시 순서가 바뀔 때만 오름). splice 등록자가 「지금 자료 기준」
69
+ * 판정을 같은 판 동안 다시 하지 않으려고 묻는다. 값의 뜻은 보장하지 않으며 버전 사이에 바뀔 수 있다.
70
+ *
71
+ * Internal: the data layer's structure version (bumped only when the row set or display order changes).
72
+ * Splice registrants ask it so they need not redo a "against the current data" check within the same
73
+ * version. Its meaning is not guaranteed and may change between versions.
74
+ *
75
+ * 内部用: データ層の構造バージョン(行の集合・表示順が変わるときだけ増える)。splice の登録者が
76
+ * 「今のデータ基準」の判定を同じバージョンの間に繰り返さないために問い合わせる。値の意味は保証せず、バージョン間で変わりうる。
77
+ *
78
+ * 内部用: 数据层的结构版本号(仅在行集合或显示顺序变化时递增)。splice 的注册者借此避免在同一版本内重复
79
+ * 「以当前数据为准」的判断。其含义不作保证,版本之间可能变化。
80
+ *
81
+ * @internal
82
+ */
83
+ get dataStructureVersion(): number;
46
84
  /**
47
85
  * group/tree 등 baseline backing 을 통째로 교체하는 등록점. provider=null 이면 plain(DataLayer 표시 순서)으로 복귀.
48
86
  * / Registration point that replaces the baseline backing wholesale (group/tree); provider=null reverts to plain (DataLayer display order).
@@ -54,9 +92,22 @@ export declare class FlatRowModel {
54
92
  * F2 DetailManager 가 합성 후단에 detail head/filler pseudo-row 를 끼워 넣을 변환기를 등록한다. 등록 순서대로 순차 적용.
55
93
  * / Register a transformer that F2 DetailManager uses to insert detail head/filler pseudo-rows at the tail of composition; applied in registration order.
56
94
  *
95
+ * 「등록되어 있다」와 「지금 끼워 넣을 것이 있다」는 다르다. 디테일 기능은 펼친 행이 없어도
96
+ * splice 를 늘 등록해 두므로, 등록 여부로 원천을 고르면 합성할 것이 없는 그리드도 칸마다
97
+ * 전 행 배열을 만든다. 그래서 등록자가 활성 술어를 같이 넘기고, 모든 splice 가 비활성이면
98
+ * 직통 원천을 쓴다. 술어 없이 등록한 splice 는 늘 활성으로 본다(뜻을 바꾸지 않는 쪽).
99
+ *
100
+ * "Registered" is not the same as "has something to insert now". The detail feature keeps its
101
+ * splice registered even with no row expanded, so choosing the source by registration would make
102
+ * a grid with nothing to compose rebuild the whole row array per cell. The registrant therefore
103
+ * passes an activity predicate as well, and when every splice is inactive the direct source is
104
+ * used. A splice registered without a predicate is treated as always active (the safe reading).
105
+ *
57
106
  * @param fn - flat 배열 변환 함수 / Flat-array transform function
107
+ * @param isActive - 지금 끼워 넣을 것이 있는지(생략하면 늘 true) / Whether it has anything to insert now (always true when omitted)
108
+ * @param version - 끼워 넣는 결과가 바뀔 때마다 오르는 판 번호(생략하면 합성 결과를 담아 두지 않는다) / A version bumped whenever the inserted result would change (when omitted the composed result is never kept)
58
109
  */
59
- registerSplice(fn: FlatSpliceFn): void;
110
+ registerSplice(fn: FlatSpliceFn, isActive?: () => boolean, version?: () => number): void;
60
111
  /** 합성 완료된 flat 행 수. / Count of composed flat rows. */
61
112
  count(): number;
62
113
  /**
@@ -78,6 +129,14 @@ export declare class FlatRowModel {
78
129
  * @returns 행 참조 정보 / Row reference info
79
130
  */
80
131
  resolveFlatRow(flatIndex: number): FlatRowRef;
132
+ /**
133
+ * flat index 가 가리키는 데이터 행(트리 노드면 그 노드의 데이터). 그룹 머리·상세 칸·범위 밖이면 null.
134
+ * / 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.
135
+ *
136
+ * @param flatIndex - 합성된 flat 배열의 인덱스 / Index into the composed flat array
137
+ * @returns 데이터 행 또는 null / The data row or null
138
+ */
139
+ rowAt(flatIndex: number): Record<string, any> | null;
81
140
  /**
82
141
  * rowId → 현재 flat index. 없으면 -1. / rowId → current flat index; -1 if absent.
83
142
  *
@@ -92,7 +151,14 @@ export declare class FlatRowModel {
92
151
  * @returns rowId 또는 null / rowId or null
93
152
  */
94
153
  rowIdOfFlat(flatIndex: number): string | null;
95
- private _flat;
154
+ /**
155
+ * 지금 상태에 맞는 원천. backing 이 없고 활성 splice 가 하나도 없으면 직통, 아니면 합성.
156
+ * / The source that fits the current state: direct when there is no backing and no active
157
+ * splice, composed otherwise.
158
+ */
159
+ private _source;
160
+ /** backing(또는 표시 순서) → splice 를 차례로 적용한 합성 배열. / The array composed from backing (or display order) through every splice in order. */
161
+ private _compose;
96
162
  private _invalidate;
97
163
  private _ensureRevIndex;
98
164
  }
@@ -1,4 +1,6 @@
1
1
  import { ColumnLayout } from './ColumnLayout.js';
2
+ import { IColumnGeometry } from './coordinate/geometryPorts.js';
3
+ import { IFooterView, IGeometryApplier, IScrollFollower } from './render/ports.js';
2
4
  /**
3
5
  * FooterManager 의존성 주입 인터페이스. / Dependency-injection interface for FooterManager.
4
6
  */
@@ -15,6 +17,11 @@ export interface FooterDeps<T extends Record<string, any>> {
15
17
  getContainer: () => HTMLElement;
16
18
  /** Phase 2: OverrideKernel.getStrategy 주입(슬롯 summaryOp 도달용). / Phase 2: injected via OverrideKernel.getStrategy (reaches the `summaryOp` slot). */
17
19
  getStrategy?: <F extends Function>(slot: string, fallback: F) => F;
20
+ /**
21
+ * 그리드의 컬럼 기하(폭·여분 컬럼). 막대를 그릴 때마다 한 번 묻는다(맞춘 뒤 돌려줌). 값 계산(computeValues·fmtNum)은 이것을 부르지 않는다.
22
+ * / The grid's column geometry, asked once per paint; value computation never calls it.
23
+ */
24
+ getGeometry: () => IColumnGeometry;
18
25
  }
19
26
  /**
20
27
  * 그리드 하단 요약 푸터(합계/평균/개수 등) 관리자. / Manages the grid's summary footer bar (sum/avg/count/…).
@@ -25,8 +32,14 @@ export interface FooterDeps<T extends Record<string, any>> {
25
32
  * them as cells aligned to column widths. The `summaryOp` override slot lets custom
26
33
  * aggregates (MEDIAN/STDEV/…) intercept the default SUM/AVG/COUNT/MAX/MIN switch.
27
34
  */
28
- export declare class FooterManager<T extends Record<string, any> = any> {
35
+ export declare class FooterManager<T extends Record<string, any> = any> implements IFooterView {
29
36
  private _d;
37
+ /** 값 계산(헤드리스). / Value computation (headless). */
38
+ private readonly _values;
39
+ /** 막대 DOM. / Bar DOM. */
40
+ private readonly _view;
41
+ /** 합계 대상 행 원천 — 부를 때마다 deps.getData 를 읽는다. / Row source; reads deps.getData on every call. */
42
+ private readonly _source;
30
43
  constructor(deps: FooterDeps<T>);
31
44
  /**
32
45
  * 숫자를 포맷 문자열에 따라 표시용 문자열로 변환한다. / Format a number into a display string according to a format string.
@@ -66,4 +79,33 @@ export declare class FooterManager<T extends Record<string, any> = any> {
66
79
  * redraws it, inserting at the top or bottom of the container per `options.footerPosition`.
67
80
  */
68
81
  render(): void;
82
+ /**
83
+ * 그리기 계획이 「푸터 막대 다시」를 말할 때(컬럼 구성·겉모양이 바뀜). render 와 같다.
84
+ * / Called when the render plan asks to rebuild the footer bar (columns or appearance changed). Same as render.
85
+ */
86
+ paint(): void;
87
+ /**
88
+ * 그리기 계획이 「푸터 값 다시」를 말할 때(행 집합·칸 값이 바뀜). 합계를 다시 셈하고 값 칸 글자만 고친다.
89
+ * 스크롤·정렬·폭 조절·선택에는 계획이 이것을 부르지 않는다 — 그래서 그때는 합계를 셈하지 않는다.
90
+ * / Called when the plan asks for new footer values (row set or cell values changed): recompute and rewrite
91
+ * value text only. Scrolling, sorting, resizing and selection never ask for it.
92
+ */
93
+ updateValues(): void;
94
+ /**
95
+ * 본문 가로 위치를 따라가게 할 객체를 넘겨 받는다(그리드가 렌더러를 만든 뒤 한 번). 그린 막대가 그 객체를 따라간다.
96
+ * / Receives the horizontal scroll follower; the painted bar follows the body's horizontal position.
97
+ */
98
+ setFollower(f: IScrollFollower | null): void;
99
+ /**
100
+ * 컬럼 폭 등록기를 넘겨 받는다(그리드가 기하·등록기를 만든 뒤). 푸터 칸 폭이 끄는 동안 머리글·본문과 같은 프레임에 따라간다.
101
+ * / Receives the geometry applier so footer cell widths follow a column drag in the same frame as header and body.
102
+ */
103
+ setApplier(a: IGeometryApplier | null): void;
104
+ /**
105
+ * 막대 끝 여백(본문 세로 스크롤바 폭)을 넘겨 받는다 — 가로로 끝까지 긁어도 푸터가 본문과 같이 가게. 0 이면 아무것도 안 씀.
106
+ * / Receives the end gutter (body vertical scrollbar width) so the footer scrolls as far as the body; 0 writes nothing.
107
+ */
108
+ setEndGutter(px: number): void;
109
+ /** 따라가기를 푼다(그리드를 없앨 때). / Releases the follower when the grid is destroyed. */
110
+ destroy(): void;
69
111
  }
@@ -2,6 +2,7 @@ import { DataLayer } from './DataLayer.js';
2
2
  import { ColumnLayout } from './ColumnLayout.js';
3
3
  import { FlatRowModel } from './FlatRowModel.js';
4
4
  import { GridOptions } from './types.js';
5
+ import { IRenderRequest } from './domain/render/ports.js';
5
6
  import { RecalcCoordinator, RecalcSummary } from './formula/RecalcCoordinator.js';
6
7
  import { FormulaErrorCode, FormulaGridAccessor } from './formula/types.js';
7
8
  /**
@@ -52,10 +53,9 @@ export interface FormulaControllerDeps<T extends Record<string, any> = any> {
52
53
  announce: (msg: string) => void;
53
54
  /** i18n: 수식 오류 announce/셀 라벨 해석(formulaError.* 통합 키). / i18n: resolve formula error announce/labels. */
54
55
  t: (key: string, params?: Record<string, string | number>) => string;
55
- /** 현재 가시 범위 렌더(this._doRender(...this._visRange())). afterRecalc 가 !skipRender 시 유발.
56
- * / Renders the currently visible range (this._doRender(...this._visRange())). Triggered by
57
- * afterRecalc when !skipRender. */
58
- doRenderWindow: () => void;
56
+ /** 그리기 요청을 낸다 — 재계산 뒤(afterRecalc 가 !skipRender 일 때) 보이는 범위를 다시 그린다. 그리기는 요청 통로 하나로만 들어가 횟수·범위를 한곳에서 정한다.
57
+ * / Submit a render request — after a recalc (afterRecalc with !skipRender), repaint the visible range. Rendering enters through a single request channel so count and range are decided in one place. */
58
+ submitRender: (req: IRenderRequest) => void;
59
59
  }
60
60
  /**
61
61
  * F3 셀 수식 컨트롤러. / F3 cell formula controller.
@@ -18,6 +18,10 @@ import { ChartManager } from './ChartManager.js';
18
18
  import { OverrideKernel } from './OverrideKernel.js';
19
19
  import { LocaleRegistry } from './i18n/LocaleRegistry.js';
20
20
  import { GridRenderer } from './GridRenderer.js';
21
+ import { IRenderScheduler } from './render/ports.js';
22
+ import { HeaderSortIndicator } from './render/header/HeaderSortIndicator.js';
23
+ import { IColumnWindow } from './coordinate/geometryPorts.js';
24
+ import { RenderController } from './RenderController.js';
21
25
  import { VirtualScroll } from './VirtualScroll.js';
22
26
  import { Pagination } from './Pagination.js';
23
27
  import { WorksheetManager } from './WorksheetManager.js';
@@ -68,6 +72,8 @@ export interface ComposerHost<T extends Record<string, any> = any> {
68
72
  _pagination: Pagination | null;
69
73
  _wsManager: WorksheetManager<T> | null;
70
74
  _colWidths: number[];
75
+ /** 렌더 루프(컬럼 기하의 주인). 마운트 때 채워짐. / Render loop (owner of the column geometry); set at mount. */
76
+ _render: RenderController<T> | null;
71
77
  _formulaDirtySeeds: Set<string>;
72
78
  emit(event: string, ...args: any[]): any;
73
79
  on(event: string, cb: (...args: any[]) => void): any;
@@ -76,7 +82,11 @@ export interface ComposerHost<T extends Record<string, any> = any> {
76
82
  _announce(msg: string): void;
77
83
  /** i18n: 메시지 해석(인스턴스 오버라이드 우선 → 활성 로케일 → ko → 키). / i18n: resolve a message (instance override first, then active locale, then ko, then the raw key). */
78
84
  t(key: string, params?: Record<string, string | number>): string;
79
- _doRender(startIndex: number, endIndex: number): void;
85
+ _doRender(startIndex: number, endIndex: number, columns?: IColumnWindow, rowWork?: 'diff'): void;
86
+ /** 그리기 요청을 받아 계획대로 실행하는 곳(그리드마다 하나). / Takes render requests and runs them per plan (one per grid). */
87
+ _scheduler: IRenderScheduler;
88
+ /** 머리글 정렬 표시만 고치는 객체(그리드마다 하나). / Patches only header sort marks (one per grid). */
89
+ _sortIndicator: HeaderSortIndicator;
80
90
  _visRange(): [number, number];
81
91
  _renderHeader(): void;
82
92
  _setFocusCell(ri: number, ci: number): void;
@@ -2,7 +2,12 @@ import { DataLayer } from './DataLayer.js';
2
2
  import { RowDragDrop } from './RowDragDrop.js';
3
3
  import { MergeEngine } from './MergeEngine.js';
4
4
  import { AppearanceResolver } from './AppearanceResolver.js';
5
+ import { _el, _style } from './render/dom.js';
6
+ import { ResizeBinderPorts } from './render/header/ResizeHandleBinder.js';
7
+ import { BodyView } from './render/body/BodyView.js';
5
8
  import { ColumnDef, SortItem, CellRange, GridOptions, FilterItem } from './types.js';
9
+ import { IColumnGeometry, IColumnWindow } from './coordinate/geometryPorts.js';
10
+ import { IScrollFollower, IHeaderSortIndicator, IGeometryApplier } from './render/ports.js';
6
11
  /**
7
12
  * R9(§6-R9 / §2.5 R-4a): 렌더러가 소비하는 opts 타입. 공개 GridOptions(생성 시 기본값 병합
8
13
  * 완료 = Required) 위에, 렌더 파이프라인이 매 프레임 주입하는 내부 증강 필드(언더스코어 접두)를
@@ -45,8 +50,8 @@ export interface RenderFrame {
45
50
  data: DataLayer<any>;
46
51
  /** 리프 컬럼 정의 배열. / Leaf column definitions. */
47
52
  leaves: ColumnDef[];
48
- /** 리프 컬럼별 너비(px). / Per-leaf column widths (px). */
49
- widths: number[];
53
+ /** 리프 컬럼별 너비(px, 읽기 전용 — 그리는 쪽은 기하에 묻는다). / Per-leaf column widths (px, read-only — painters ask the geometry). */
54
+ widths: readonly number[];
50
55
  /** 렌더 옵션(내부 증강 포함). / Render options (with internal augmentation). */
51
56
  opts: RenderOptions;
52
57
  /** 가상 스크롤 상단 오프셋(px). / Virtual-scroll top offset (px). */
@@ -69,6 +74,10 @@ export interface RenderFrame {
69
74
  mergeEngine?: MergeEngine | undefined;
70
75
  /** 마스터/디테일 렌더 배선(F2, 비활성 시 undefined). / Master/detail render wiring (F2; undefined when disabled). */
71
76
  detailApi?: DetailRenderContext | undefined;
77
+ /** 이번에 그릴 컬럼 창(없으면 전 컬럼). / Column window to paint this time (absent = all columns). */
78
+ columns?: IColumnWindow | undefined;
79
+ /** 'diff' 이면 세로로 겹치는 행은 그대로 두고 들어온 행만 만들고 나간 행만 뗀다(없으면 통째). / 'diff' keeps overlapping rows and only adds/removes rows that enter/leave (absent = rebuild). */
80
+ rowWork?: 'diff';
72
81
  }
73
82
  /**
74
83
  * 렌더러가 상위(RenderController/OpenGrid)로 이벤트를 되돌리고 상태를 질의하는 콜백 묶음.
@@ -103,7 +112,7 @@ export interface RendererCallbacks {
103
112
  approx: boolean;
104
113
  } | null;
105
114
  t?: (key: string, params?: Record<string, string | number>) => string;
106
- applyCF?: (cellEl: HTMLElement, rowIndex: number, field: string, value: unknown, cellW: number, cellH: number) => void;
115
+ applyCF?: (cellEl: HTMLElement, rowIndex: number, field: string, value: unknown, cellW: number, cellH: number, track?: (bar: HTMLElement, ratio: number) => void) => void;
107
116
  }
108
117
  /**
109
118
  * F2(§4/§5, C6/C10): renderBody 가 detail head/filler 분기·expander 셀을 그릴 때 소비하는 배선
@@ -152,9 +161,54 @@ export declare class GridRenderer {
152
161
  private _bodyWrap;
153
162
  private _body;
154
163
  private _opts;
155
- private _cbs;
164
+ private readonly _cbs;
156
165
  private _ap;
157
166
  private _cellMap;
167
+ private _resize;
168
+ private _headerView;
169
+ private _bodyView;
170
+ private readonly _follower;
171
+ private _applier;
172
+ private _gutter;
173
+ private _gutterSink;
174
+ /**
175
+ * 본문 가로 위치를 따라가는 객체(읽기만). 푸터 막대처럼 본문과 같이 가로로 움직여야 하는 요소가 같은 객체에 붙는다.
176
+ *
177
+ * The follower of the body's horizontal position (read-only). Elements that must scroll with the body, such as the footer bar, attach to the same object.
178
+ */
179
+ get follower(): IScrollFollower;
180
+ /**
181
+ * 기하 px 를 DOM 에 쓰는 객체(읽기만 — 기하를 받기 전엔 null). 스케줄러·푸터가 같은 객체로 폭 자리를 고친다.
182
+ *
183
+ * The geometry-to-DOM writer (read-only; null before the geometry arrives). The scheduler and the footer patch width spots through it.
184
+ */
185
+ get applier(): IGeometryApplier | null;
186
+ /**
187
+ * 본문 그리개(읽기만). 스케줄러가 가로 창이 바뀐 프레임에 이것에 「창 옮김」을 시킨다.
188
+ *
189
+ * The body painter (read-only). The scheduler asks it to shift the column window in frames where the window changes.
190
+ */
191
+ get bodyView(): BodyView;
192
+ /**
193
+ * 오른쪽 끝 여백 값을 받을 입구를 둔다(푸터 막대가 머리글과 같은 여백을 갖게). 이미 잰 값이 있으면 바로 한 번 넘긴다.
194
+ *
195
+ * Register the sink for the end-gutter value (so the footer bar gets the same gutter as the header); an already measured value is passed once right away.
196
+ */
197
+ onEndGutter(fn: (px: number) => void): void;
198
+ /**
199
+ * 너비 손잡이에 실시간 조절 포트(폭 쓰기·스케줄러·놓음 알림·기하)를 한 번 넘긴다. 넘긴 뒤로 끄는 동안 폭은 요청으로만 반영된다.
200
+ *
201
+ * Hand the width handles the live-resize ports (width writer, scheduler, release sink, geometry) once; afterwards drags reach the screen only through requests.
202
+ *
203
+ * @param ports - 실시간 조절 포트 / Live-resize ports
204
+ */
205
+ connectResize(ports: ResizeBinderPorts): void;
206
+ /**
207
+ * 놓은 폭을 렌더러 콜백(onColResize)으로 넘긴다 — 손잡이를 실시간 조절에 이은 뒤에도 놓기 한 번에 콜백 한 번이 지금처럼 불리게.
208
+ *
209
+ * Forward a released width to the renderer callback (onColResize), so the callback still fires once per release after live resize is wired.
210
+ */
211
+ commitColumnResize(ci: number, width: number): void;
158
212
  /** 본문 스크롤 래퍼 요소(스크롤/뷰포트 계산 접근용). / The body scroll-wrapper element (for scroll/viewport calculations). */
159
213
  get bodyWrapper(): HTMLElement;
160
214
  /** i18n: 렌더 로케일 해석기 — cbs.t(인스턴스 로케일) 우선, 미주입 시 전역 t. / i18n: cbs.t (instance locale) first, global t otherwise. */
@@ -177,6 +231,21 @@ export declare class GridRenderer {
177
231
  * @param headerHeight - 헤더 높이(px) / Header height (px)
178
232
  */
179
233
  updateSize(totalHeight: number, headerHeight: number): void;
234
+ /**
235
+ * 머리글의 정렬 표시만 고치는 객체를 머리글 그리개에 넘긴다(그리드마다 하나). 첫 머리글을 그리기 전에 한 번.
236
+ *
237
+ * Hand the header painter the object that patches only sort marks (one per grid). Once, before the first header paint.
238
+ *
239
+ * @param sort - 정렬 표시 객체 / The sort-indicator object
240
+ */
241
+ setSortIndicator(sort: IHeaderSortIndicator): void;
242
+ /**
243
+ * 머리글·본문 그리개에 컬럼 기하를 넘긴다(그리드마다 하나 — 폭·왼쪽 위치·전체 폭은 여기에 묻는다). 마운트 때 한 번.
244
+ * / Hand the header/body painters the column geometry (one per grid — they ask it for width, left and total). Once at mount.
245
+ *
246
+ * @param geometry - 컬럼 기하 / The column geometry
247
+ */
248
+ setGeometry(geometry: IColumnGeometry): void;
180
249
  /**
181
250
  * 현재 렌더된 헤더 영역의 실제 높이(px). 헤더 줄바꿈으로 늘어난 높이를 레이아웃에 반영할 때 사용.
182
251
  * / The actual height (px) of the currently rendered header. Used to reflect height grown by
@@ -197,7 +266,7 @@ export declare class GridRenderer {
197
266
  * @param sortList - 활성 정렬 항목 / Active sort items
198
267
  * @param opts - 렌더 옵션(고정 컬럼 수·필터 등) / Render options (frozen count, filters, …)
199
268
  */
200
- renderHeader(headerRows: any[][], leaves: ColumnDef[], widths: number[], sortList: SortItem[], opts: RenderOptions): void;
269
+ renderHeader(headerRows: any[][], leaves: ColumnDef[], widths: readonly number[], sortList: SortItem[], opts: RenderOptions): void;
201
270
  /**
202
271
  * 본문 가시 구간을 다시 그린다 — 그룹/트리 행·상태/선택 배경·고정 컬럼·셀 병합·마스터/디테일
203
272
  * 패널·수식 메타를 반영하고, rowIndex→colIndex→cellEl 맵을 재구성한다(getCellEl 근거).
@@ -218,13 +287,6 @@ export declare class GridRenderer {
218
287
  * @returns 셀 요소 또는 undefined / The cell element, or undefined
219
288
  */
220
289
  getCellEl(rowIndex: number, colIndex: number): HTMLElement | undefined;
221
- /**
222
- * F2(§4.3 C6): full-width 디테일 패널을 body-absolute 로 그린다(병합 마스터셀 선례
223
- * `:783-806` 재사용 — flex flow 밖). host 는 detailApi.getPanelHost() 가 반환하는 영속
224
- * div(mount-once, §5) — 이 함수는 그 host 를 새 패널 wrapper 에 appendChild 할 뿐이며,
225
- * DOM 이동만 발생하므로(파괴 아님) 재렌더/스크롤 왕복에도 인스턴스 상태가 생존한다.
226
- */
227
- private _appendDetailPanel;
228
290
  /**
229
291
  * 렌더러가 마운트한 DOM 을 전부 제거해 루트를 비운다.
230
292
  * / Remove all DOM the renderer mounted, emptying the root.
@@ -232,15 +294,18 @@ export declare class GridRenderer {
232
294
  destroy(): void;
233
295
  }
234
296
  /**
235
- * 태그(+선택 className)로 요소를 만든다. / Create an element from a tag (+optional className).
297
+ * 디테일 펼침 단추(F2 §4.5) 하나를 만든다. 기존 시험이 이 파일의 글자에서 단추의 시각 크기(min-width/min-height)를
298
+ * 읽어 터치 히트 영역을 확인하므로, 본문 그리기를 옮긴 뒤에도 단추를 만드는 줄은 이 파일에 둔다.
299
+ * / Build one detail expander button (F2 §4.5). An existing test reads the button's visual size from this file's text
300
+ * to check the touch hit area, so the lines that build it stay in this file after body painting moved out.
236
301
  * @internal
237
302
  */
238
- export declare function _el(tag: string, className?: string): HTMLElement;
239
- /**
240
- * 요소 style 에 부분 스타일을 병합한다. / Merge a partial style bag into an element's style.
241
- * @internal
242
- */
243
- export declare function _style(el: HTMLElement, styles: Partial<CSSStyleDeclaration>): void;
303
+ export declare function _detailExpanderButton(glyphInfo: {
304
+ glyph: string;
305
+ ariaLabel: string;
306
+ title: string;
307
+ }, rid: string, ri: number, detailApi: DetailRenderContext): HTMLElement;
308
+ export { _el, _style };
244
309
  /**
245
310
  * 문자열 내용을 파일로 다운로드시킨다(Blob URL 생성 후 즉시 해제).
246
311
  * / Trigger a file download of string content (creates then immediately revokes a Blob URL).
@@ -2,6 +2,7 @@ import { DataLayer } from './DataLayer.js';
2
2
  import { VirtualScroll } from './VirtualScroll.js';
3
3
  import { GroupRow } from './GroupEngine.js';
4
4
  import { TreeNode } from './TreeEngine.js';
5
+ import { IRenderRequest } from './domain/render/ports.js';
5
6
  /**
6
7
  * {@link GroupTreeManager} 의존성 주입 계약. / Dependency-injection contract for {@link GroupTreeManager}.
7
8
  *
@@ -18,10 +19,11 @@ export interface GroupTreeDeps<T extends Record<string, any>> {
18
19
  getOptions: () => any;
19
20
  /** 가상 스크롤 인스턴스 조회(없으면 `null`). / Look up the virtual-scroll instance (or `null`). */
20
21
  getVs: () => VirtualScroll | null;
21
- /** 전체 재계산 렌더(총 행수 갱신 포함). / Full re-render including a total-row-count refresh. */
22
- doRenderFull: (totalRows: number) => void;
23
- /** 바디를 다시 그린다. / Re-render the body. */
24
- doRender: () => void;
22
+ /**
23
+ * 그리기 요청을 낸다(받는 쪽이 계획대로 그린다). 이 객체는 무엇을 그릴지 정하지 않고 「무엇이 바뀌었나」만 알린다.
24
+ * / Submit a render request (the receiver paints per plan). This object reports what changed, not what to paint.
25
+ */
26
+ submitRender: (req: IRenderRequest) => void;
25
27
  /** Phase 2: OverrideKernel.getStrategy 주입(슬롯 groupKeyFn 도달용).
26
28
  * / Phase 2: injected `OverrideKernel.getStrategy` (reaches the `groupKeyFn` slot). */
27
29
  getStrategy?: <F extends Function>(slot: string, fallback: F) => F;
@@ -2,6 +2,7 @@ import { DataLayer } from './DataLayer.js';
2
2
  import { ColumnLayout } from './ColumnLayout.js';
3
3
  import { CellEditManager } from './CellEditManager.js';
4
4
  import { RowManager } from './RowManager.js';
5
+ import { IRenderRequest } from './domain/render/ports.js';
5
6
  /**
6
7
  * F1 범위 선택 배선 훅(M-3/M-4/M-5) — RangeSelectionManager 가 그대로 구현한다.
7
8
  * / F1 range-selection wiring hooks (M-3/M-4/M-5) — implemented directly by
@@ -57,8 +58,8 @@ export interface KeyboardDeps<T extends Record<string, any>> {
57
58
  setFocusCell: (ri: number, ci: number) => void;
58
59
  /** 행 드래그(Ctrl+화살표) 이동을 처리한다. / Handle a row drag (Ctrl+Arrow) move. */
59
60
  handleRowDrop: (from: number, to: number) => void;
60
- /** 바디를 다시 그린다. / Re-render the body. */
61
- doRender: () => void;
61
+ /** 그리기 요청을 낸다(보이는 범위 다시 그리기 등). / Submit a render request (e.g. repaint the visible range). */
62
+ submitRender: (req: IRenderRequest) => void;
62
63
  /** 스크린리더용 상태 안내. / Announce a status message for screen readers. */
63
64
  announce: (msg: string) => void;
64
65
  /** i18n: 행 이동 announce 해석. / i18n: resolve row-move announce. */
@@ -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. */