open-grid 1.6.1 → 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 (111) hide show
  1. package/CHANGELOG.md +28 -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-VkKgQ506.js → index-B9_g5Eg3.js} +2 -2
  13. package/dist/{index-D0DJtKYI.cjs → index-CnyumyPV.cjs} +2 -2
  14. package/dist/open-grid-react.cjs +1 -1
  15. package/dist/open-grid-react.js +1 -1
  16. package/dist/open-grid-vue.cjs +1 -1
  17. package/dist/open-grid-vue.js +1 -1
  18. package/dist/open-grid.cjs +1 -1
  19. package/dist/open-grid.js +2 -2
  20. package/dist/sinks-BWkWQexV.js +149 -0
  21. package/dist/sinks-DPK0VxYG.cjs +143 -0
  22. package/dist/types/core/CFRenderBridge.d.ts +5 -1
  23. package/dist/types/core/CellEditManager.d.ts +26 -2
  24. package/dist/types/core/CellEventHandler.d.ts +6 -2
  25. package/dist/types/core/ColumnLayout.d.ts +8 -0
  26. package/dist/types/core/DataLayer.d.ts +48 -1
  27. package/dist/types/core/DetailManager.d.ts +43 -2
  28. package/dist/types/core/ExportManager.d.ts +24 -0
  29. package/dist/types/core/FindBarManager.d.ts +6 -2
  30. package/dist/types/core/FlatRowModel.d.ts +61 -3
  31. package/dist/types/core/FooterManager.d.ts +43 -1
  32. package/dist/types/core/FormulaController.d.ts +4 -4
  33. package/dist/types/core/GridComposer.d.ts +11 -1
  34. package/dist/types/core/GridRenderer.d.ts +84 -19
  35. package/dist/types/core/GroupTreeManager.d.ts +6 -4
  36. package/dist/types/core/KeyboardManager.d.ts +3 -2
  37. package/dist/types/core/MutationService.d.ts +10 -8
  38. package/dist/types/core/OpenGrid.d.ts +7 -5
  39. package/dist/types/core/RangeSelectionManager.d.ts +23 -2
  40. package/dist/types/core/RenderController.d.ts +126 -8
  41. package/dist/types/core/SortFilterManager.d.ts +10 -2
  42. package/dist/types/core/VirtualScroll.d.ts +12 -0
  43. package/dist/types/core/coordinate/CellTextPolicy.d.ts +58 -0
  44. package/dist/types/core/coordinate/ColumnGeometry.d.ts +60 -0
  45. package/dist/types/core/coordinate/ColumnWindow.d.ts +40 -0
  46. package/dist/types/core/coordinate/ColumnWindowPolicy.d.ts +89 -0
  47. package/dist/types/core/coordinate/ExtraColumns.d.ts +39 -0
  48. package/dist/types/core/coordinate/RangeRectCalculator.d.ts +35 -0
  49. package/dist/types/core/coordinate/ViewportHeightJudge.d.ts +28 -0
  50. package/dist/types/core/coordinate/geometryPorts.d.ts +250 -0
  51. package/dist/types/core/coordinate/ports.d.ts +5 -0
  52. package/dist/types/core/domain/footer/FooterValues.d.ts +50 -0
  53. package/dist/types/core/domain/footer/ports.d.ts +31 -0
  54. package/dist/types/core/domain/render/RenderPlanner.d.ts +17 -0
  55. package/dist/types/core/domain/render/RenderRequest.d.ts +91 -0
  56. package/dist/types/core/domain/render/ports.d.ts +169 -0
  57. package/dist/types/core/domain/resize/ResizeGesture.d.ts +25 -0
  58. package/dist/types/core/domain/resize/ResizeHitZone.d.ts +23 -0
  59. package/dist/types/core/domain/resize/ports.d.ts +64 -0
  60. package/dist/types/core/domain/sort/ComparisonOrderer.d.ts +11 -0
  61. package/dist/types/core/domain/sort/LcpMergeOrderer.d.ts +15 -0
  62. package/dist/types/core/domain/sort/RankIndex.d.ts +74 -0
  63. package/dist/types/core/domain/sort/SortCostEstimate.d.ts +36 -0
  64. package/dist/types/core/domain/sort/SortKeyColumn.d.ts +89 -0
  65. package/dist/types/core/domain/sort/SortKeyStore.d.ts +34 -0
  66. package/dist/types/core/domain/sort/Sorter.d.ts +54 -0
  67. package/dist/types/core/domain/sort/SyncSortRunner.d.ts +9 -0
  68. package/dist/types/core/domain/sort/commonPrefix.d.ts +5 -0
  69. package/dist/types/core/domain/sort/ports.d.ts +140 -0
  70. package/dist/types/core/export/ExportProgressView.d.ts +28 -0
  71. package/dist/types/core/export/channels/XlsxChannel.d.ts +29 -0
  72. package/dist/types/core/export/channels/XlsxWorkbookWriter.d.ts +17 -0
  73. package/dist/types/core/export/index.d.ts +2 -0
  74. package/dist/types/core/export/sinks.d.ts +81 -0
  75. package/dist/types/core/host/archCheck.d.ts +16 -1
  76. package/dist/types/core/i18n/locales/en.d.ts +6 -0
  77. package/dist/types/core/i18n/locales/ko.d.ts +6 -0
  78. package/dist/types/core/i18n/types.d.ts +8 -0
  79. package/dist/types/core/render/FooterView.d.ts +121 -0
  80. package/dist/types/core/render/GeometryApplier.d.ts +55 -0
  81. package/dist/types/core/render/HorizontalReveal.d.ts +26 -0
  82. package/dist/types/core/render/RangeOverlayAdapter.d.ts +10 -0
  83. package/dist/types/core/render/RenderScheduler.d.ts +225 -0
  84. package/dist/types/core/render/ResizeSinkAdapter.d.ts +35 -0
  85. package/dist/types/core/render/ScrollFollower.d.ts +34 -0
  86. package/dist/types/core/render/ScrollObserver.d.ts +47 -0
  87. package/dist/types/core/render/ScrollbarGutter.d.ts +19 -0
  88. package/dist/types/core/render/body/BodyEventRouter.d.ts +58 -0
  89. package/dist/types/core/render/body/BodyRowSet.d.ts +28 -0
  90. package/dist/types/core/render/body/BodyView.d.ts +185 -0
  91. package/dist/types/core/render/body/CellLocator.d.ts +36 -0
  92. package/dist/types/core/render/body/CellRegistry.d.ts +24 -0
  93. package/dist/types/core/render/body/ColumnPaintPlan.d.ts +19 -0
  94. package/dist/types/core/render/body/ExtraCellPainters.d.ts +20 -0
  95. package/dist/types/core/render/body/rows/BodyRowContext.d.ts +138 -0
  96. package/dist/types/core/render/body/rows/DataRowPainter.d.ts +58 -0
  97. package/dist/types/core/render/body/rows/DetailRowPainter.d.ts +24 -0
  98. package/dist/types/core/render/body/rows/GroupRowPainter.d.ts +32 -0
  99. package/dist/types/core/render/body/rows/RowPainterTable.d.ts +24 -0
  100. package/dist/types/core/render/body/rows/WindowLayout.d.ts +38 -0
  101. package/dist/types/core/render/dom.d.ts +10 -0
  102. package/dist/types/core/render/header/HeaderSortIndicator.d.ts +39 -0
  103. package/dist/types/core/render/header/HeaderView.d.ts +84 -0
  104. package/dist/types/core/render/header/ResizeHandleBinder.d.ts +110 -0
  105. package/dist/types/core/render/ports.d.ts +218 -0
  106. package/dist/types/core/renderers/CellRenderer.d.ts +7 -0
  107. package/dist/types/core/types.d.ts +70 -0
  108. package/dist/types/vue/OpenGrid.vue.d.ts +1 -1
  109. package/package.json +2 -8
  110. package/dist/OpenGrid-CLk8Vt7j.cjs +0 -7459
  111. package/dist/OpenGrid-D6YxCsnV.js +0 -7472
@@ -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
  /**
@@ -100,7 +151,14 @@ export declare class FlatRowModel {
100
151
  * @returns rowId 또는 null / rowId or null
101
152
  */
102
153
  rowIdOfFlat(flatIndex: number): string | null;
103
- 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;
104
162
  private _invalidate;
105
163
  private _ensureRevIndex;
106
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. */
@@ -7,6 +7,7 @@ import { RowManager } from './RowManager.js';
7
7
  import { GroupTreeManager } from './GroupTreeManager.js';
8
8
  import { TriggerManager } from './TriggerManager.js';
9
9
  import { GridOptions, Position } from './types.js';
10
+ import { IRenderRequest } from './domain/render/ports.js';
10
11
  /**
11
12
  * R4(§3.4, R-9a/R-9b): 모든 데이터 변경의 mutate→render→emit 꼬리를 단일 초크포인트
12
13
  * `commit(spec)` 로 수렴시키기 위한 명시 데이터계약(CommitSpec DTO). 각 mutator 의
@@ -23,12 +24,12 @@ import { GridOptions, Position } from './types.js';
23
24
  * / Updates the VS/Pagination row count. `'count'` = current row count
24
25
  * (insert/delete/push/unshift), `'zero'` = 0 (clearData). Omitted = no update
25
26
  * (writeCell/setData — row count unchanged, or handled inline).
26
- * - `renderMode` : 'sync-window'=`_doRender(...visRange)`(insert/delete/write/endBatch),
27
- * 'full'=`_doRender(0,-1)`(clearData),
27
+ * - `renderMode` : 'sync-window'=보이는 범위 그리기 요청(insert/delete/write/endBatch),
28
+ * 'full'=본문 비우기 요청 rows:'clear'(clearData),
28
29
  * 'async-vs'=명령형 렌더 없음. setData 는 setTotalRows/rebuild 로 VS 가
29
30
  * rAF 스케줄(비동기)하므로 `commit` 은 동기 `_doRender` 를 **하지 않는다**.
30
- * / `'sync-window'` = `_doRender(...visRange)` (insert/delete/write/endBatch),
31
- * `'full'` = `_doRender(0,-1)` (clearData), `'async-vs'` = no imperative render.
31
+ * / `'sync-window'` = a visible-range render request (insert/delete/write/endBatch),
32
+ * `'full'` = a clear-body request, rows:'clear' (clearData), `'async-vs'` = no imperative render.
32
33
  * For setData, VS schedules via rAF through setTotalRows/rebuild, so `commit`
33
34
  * **does not** invoke a synchronous `_doRender`.
34
35
  * - `emitBeforeRender` : true=emit 을 render 앞에(writeCell/endBatch — 현행 순서), 기본 false=render 먼저(insert/delete).
@@ -108,10 +109,11 @@ export interface MutationServiceDeps<T extends Record<string, any> = any> {
108
109
  applyFilters: () => void;
109
110
  /** writeCell/endBatch 커밋 emit 직전 수식 dirty seed 소비. / Consume formula dirty seeds right before the writeCell/endBatch commit emit. */
110
111
  flushFormula: () => void;
111
- /** 현재 가시 범위 렌더(this._doRender(...this._visRange())). 서비스는 렌더 내부를 모른다. / Render the current visible range (this._doRender(...this._visRange())). The service has no knowledge of render internals. */
112
- doRenderWindow: () => void;
113
- /** 전체 렌더(this._doRender(0, -1)) — clearData full 모드. / Full render (this._doRender(0, -1)) — clearData's full mode. */
114
- doRenderFull: () => void;
112
+ /**
113
+ * 그리기 요청을 낸다. 'sync-window' 는 보이는 범위, 'full'(clearData) 은 본문 비우기 요청. 서비스는 렌더 내부를 모른다.
114
+ * / Submit a render request: 'sync-window' = visible range, 'full' (clearData) = clear the body. The service has no knowledge of render internals.
115
+ */
116
+ submitRender: (req: IRenderRequest) => void;
115
117
  /** setData: 수식 dirty seed clear + RecalcCoordinator 재생성(rowId 재발급 대응). / setData: clears formula dirty seeds and recreates the RecalcCoordinator (to cope with rowId reissuance). */
116
118
  resetFormulaState: () => void;
117
119
  /** writeCell: 값이 바뀐 셀을 수식 dirty seed 로 적립(kind==='data' 일 때만). / writeCell: accumulates a changed cell as a formula dirty seed (only when kind === 'data'). */
@@ -135,6 +135,8 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
135
135
  private _vs;
136
136
  private _ro;
137
137
  private _renderer;
138
+ private _scheduler;
139
+ private _sortIndicator;
138
140
  private _appearance;
139
141
  /**
140
142
  * R12c: per-instance 아이콘 오버라이드 레지스트리(전역 iconRegistry 의 child). 첫 setIcon 때 지연 생성.
@@ -3136,15 +3138,15 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
3136
3138
  */
3137
3139
  jumpToRow(rowIndex: number): void;
3138
3140
  /**
3139
- * @deprecated no-op stub — 특정 컬럼으로 가로 스크롤 이동 미구현. 행 이동은 `jumpToRow(rowIndex)` 사용.
3141
+ * 필드 이름의 컬럼이 보이게 가로로 스크롤한다(가로 가상화로 칸이 DOM 에 없어도 됨). 없는 필드·숨은 컬럼이면 아무 일 없음.
3140
3142
  *
3141
- * no-op stub — horizontal jump-to-column is not implemented; use `jumpToRow(rowIndex)`.
3143
+ * Scroll horizontally so the column with this field is visible (works even when column virtualization keeps its cells out of the DOM). Unknown or hidden fields do nothing.
3142
3144
  *
3143
- * no-op スタブ — 特定の列への横スクロール移動は未実装です。行の移動は `jumpToRow(rowIndex)` を使ってください。
3145
+ * フィールド名の列が見えるように横スクロールします(列の仮想化でセルが DOM に無くても動きます)。存在しない・非表示の列なら何もしません。
3144
3146
  *
3145
- * no-op 桩 — 向特定列的横向滚动移动未实现。行的移动请用 `jumpToRow(rowIndex)`。
3147
+ * 横向滚动使该字段的列可见(即使列虚拟化使其单元格不在 DOM 中也可)。不存在或隐藏的字段不做任何事。
3146
3148
  */
3147
- jumpToCol(_field: string): void;
3149
+ jumpToCol(field: string): void;
3148
3150
  /**
3149
3151
  * 현재 스크롤 좌표.
3150
3152
  *
@@ -6,6 +6,7 @@ import { FlatRowModel } from './FlatRowModel.js';
6
6
  import { GridOptions } from './types.js';
7
7
  import { RangeStats } from './range/RangeQuery.js';
8
8
  import { CellRange, Direction, FillMode, FillPreview } from './range/types.js';
9
+ import { IRenderRequest } from './domain/render/ports.js';
9
10
  /**
10
11
  * RangeSelectionManager 가 OpenGrid 서브시스템을 읽고 쓰기 위해 주입받는 클로저 묶음.
11
12
  * / Closures injected into RangeSelectionManager so it can read and write OpenGrid subsystem
@@ -30,8 +31,8 @@ export interface RangeSelectionDeps<T extends Record<string, any>> {
30
31
  getDisplayValue: (ri: number, field: string) => string;
31
32
  /** 그리드 이벤트 발행. / Emit a grid event. */
32
33
  emit: (event: string, ...args: any[]) => void;
33
- /** 현재 가시 범위를 재렌더. / Re-render the currently visible range. */
34
- doRender: () => void;
34
+ /** 그리기 요청을 낸다(보이는 범위 다시 그리기 등). / Submit a render request (e.g. repaint the visible range). */
35
+ submitRender: (req: IRenderRequest) => void;
35
36
  /** aria-live 영역에 메시지를 공지. / Announce a message via the aria-live region. */
36
37
  announce: (msg: string) => void;
37
38
  /** i18n: 범위 선택/채우기 announce·aria 해석. / i18n: resolve range selection/fill announce & aria. */
@@ -39,6 +40,18 @@ export interface RangeSelectionDeps<T extends Record<string, any>> {
39
40
  hasCellFormula?: (rowId: string, field: string) => boolean;
40
41
  offsetFormula?: (rowId: string, field: string, dRow: number, dCol: number) => string;
41
42
  setCellFormulaByRowId?: (rowId: string, field: string, formula: string) => void;
43
+ /**
44
+ * 범위의 화면 사각형을 기하로 계산(본문 상자 보이는 왼쪽 위 기준, 두 모서리 칸의 합집합 — 칸을 재는 것과 같은 뜻).
45
+ * 모서리 칸이 가로 창 밖이라 DOM 에 없을 때 쓴다. 없으면 그때 테두리를 숨긴다(지금 동작).
46
+ * / Geometry-based screen rectangle of a range (body scroller's visible top-left, union of the corner cells);
47
+ * used when a corner cell is outside the column window. Without it the border is hidden then.
48
+ */
49
+ rangeRect?: (range: CellRange) => {
50
+ left: number;
51
+ top: number;
52
+ width: number;
53
+ height: number;
54
+ } | null;
42
55
  }
43
56
  /**
44
57
  * F1 범위 선택 + 채우기 매니저. / F1 range selection + fill manager.
@@ -195,6 +208,14 @@ export declare class RangeSelectionManager<T extends Record<string, any> = any>
195
208
  * / Runs after every _doRender call (M-6 integration point) — measures the corner cells and
196
209
  * updates the contiguous border/handle/preview overlay (QA-2, CON-4). */
197
210
  repaint(): void;
211
+ /**
212
+ * 범위의 본문 상자 기준 사각형. 두 모서리 칸이 다 그려져 있으면 지금처럼 칸을 재고(창이 전 컬럼이면 결과가 지금과 같다),
213
+ * 하나라도 가로 창 밖이라 없으면 기하로 계산한다(넓은 범위의 테두리가 창 밖 모서리 때문에 사라지지 않게). 둘 다 안 되면 null.
214
+ *
215
+ * Body-scroller box of a range: measure the corner cells when both are rendered (identical to before for a full
216
+ * window); otherwise compute it from geometry so a wide range keeps its border. null when neither works.
217
+ */
218
+ private _boxOf;
198
219
  private _hideOverlay;
199
220
  /** OpenGrid._doRender 가 renderBody extraOpts 로 전달(M-6).
200
221
  * / Passed by OpenGrid._doRender as renderBody's extraOpts (M-6).