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
@@ -0,0 +1,250 @@
1
+ import { Px, LeafColIndex, ViewIndex } from './types.js';
2
+ /** 여분 컬럼 종류. 그리는 순서는 이 나열 순서와 같다(state→drag→rowNumber→check→detail). */
3
+ export type ExtraColumnId = 'state' | 'drag' | 'rowNumber' | 'check' | 'detail';
4
+ /** 여분 컬럼의 켜짐·순서·폭을 아는 유일한 곳(불변 값). / Sole owner of extra-column on/off, order, width. */
5
+ export interface IExtraColumns {
6
+ readonly ids: readonly ExtraColumnId[];
7
+ widthOf(id: ExtraColumnId): Px;
8
+ /** 고정(sticky) 때 left. leftOf(ids[0]) = 0. */
9
+ leftOf(id: ExtraColumnId): Px;
10
+ /** Σ 켜진 여분 컬럼 폭. */
11
+ width(): Px;
12
+ }
13
+ /** 기하가 바뀐 몫. 값을 바꾸는 메서드가 돌려준다. / What changed in geometry. */
14
+ export interface GeometryChange {
15
+ /** 아무것도 안 바뀜(같은 폭을 다시 넣은 경우 등). */
16
+ readonly none: boolean;
17
+ /** 폭이 바뀐 표시 잎 컬럼 번호(오름차순). */
18
+ readonly widthCols: readonly LeafColIndex[];
19
+ /** 이 컬럼부터 left 가 바뀜(없으면 count). */
20
+ readonly leftFrom: LeafColIndex;
21
+ readonly totalChanged: boolean;
22
+ /** 컬럼 수·순서·여분 컬럼·고정 수가 바뀜 → 투영을 처음부터 다시 깔아야 함. */
23
+ readonly structural: boolean;
24
+ /** 바뀐 뒤 기하 판 번호. */
25
+ readonly version: number;
26
+ }
27
+ /**
28
+ * 컬럼 기하 읽기 포트 — 그리기 객체·창 정책·범위 계산은 이것만 안다.
29
+ * 불변: leftOf(0) = extra.width(); leftOf(i+1) − leftOf(i) = widthOf(i); totalWidth() = leftOf(count).
30
+ * / Read port of column geometry. left includes extra columns.
31
+ */
32
+ export interface IColumnGeometry {
33
+ readonly version: number;
34
+ /** 표시 잎 컬럼 수. */
35
+ readonly count: number;
36
+ /** 왼쪽 고정 잎 컬럼 수. 늘 [0, count] 로 잘려 있다(옵션 값이 컬럼 수보다 커도 count 를 넘지 않음). */
37
+ readonly frozenCount: number;
38
+ readonly extra: IExtraColumns;
39
+ widthOf(ci: LeafColIndex): Px;
40
+ /** 여분 컬럼 폭을 포함한 내용 좌표의 왼쪽. */
41
+ leftOf(ci: LeafColIndex): Px;
42
+ /** [ci, ci+span) 폭의 합(가로 병합·푸터 colspan). */
43
+ spanWidth(ci: LeafColIndex, span: number): Px;
44
+ totalWidth(): Px;
45
+ /** 고정 구역 오른쪽 끝(= leftOf(frozenCount)). */
46
+ frozenRight(): Px;
47
+ /** 내용 x → 그 x 를 담는 잎 컬럼(이분 탐색). x 가 여분 구역이면 0. */
48
+ colAt(x: Px): LeafColIndex;
49
+ /** 읽기 전용(얼린) 폭 배열 — 바뀔 때마다 새 배열. RenderController 가 머리글·본문에 넘기는 폭이 이것이다(deps getColWidths() 는 계산 결과 날 배열을 그대로 줌 — 내보내기·푸터의 빈 폭 규칙 때문). */
50
+ widths(): readonly number[];
51
+ /**
52
+ * 그 판 이후 바뀐 몫을 합쳐 돌려준다(스케줄러가 「마지막으로 DOM 에 반영한 판」을 들고 프레임마다 묻는다).
53
+ * 같은 판이면 change.none. 구조 변경이 끼면 structural.
54
+ */
55
+ changesSince(version: number): GeometryChange;
56
+ }
57
+ /**
58
+ * 컬럼 폭 쓰기 포트 — 너비 조절(끄는 동안·놓을 때·Esc)이 폭을 바꾸는 유일한 길. 구현은 폭 입력의 주인(RenderController.setUserWidth):
59
+ * 폭을 정수로 만든 뒤 계산 결과 배열과 기하에 같은 값을 쓰고, 기하의 바뀐 몫을 돌려준다. 기하 쓰기 포트(IColumnGeometryWriter)는 넘기지 않는다.
60
+ *
61
+ * Column width write port — the only way width resizing (drag, release, Esc) changes a width. Implemented by the width owner
62
+ * (RenderController.setUserWidth): rounds to an integer, writes the same value to the computed-width array and the geometry,
63
+ * and returns the geometry change. The geometry writer port itself is never handed out.
64
+ */
65
+ export interface IColumnWidthWriter {
66
+ setWidth(ci: LeafColIndex, width: number): GeometryChange;
67
+ }
68
+ /** 기하 쓰기 포트 — 넘겨받는 객체 없음: RenderController 안(syncGeometry 의 reset, setUserWidth 의 resize)에서만 쓴다. */
69
+ export interface IColumnGeometryWriter extends IColumnGeometry {
70
+ /**
71
+ * 폭 배열·여분·고정 수를 통째로 갈아 넣음(recalcWidths·컬럼 구성 변경). 다시 계산된 폭이라 **0 이상 유한한 폭은 그대로** 든다
72
+ * (0·소수 포함, 반올림·하한 없음 — 폭 0 컬럼도 지금처럼 0px). 음수·NaN·무한대는 0, 아주 큰 값은 상한으로 자른다(누적 합이 단조·유한하게).
73
+ */
74
+ reset(widths: readonly number[], extra: IExtraColumns, frozenCount: number): GeometryChange;
75
+ /**
76
+ * 컬럼 하나의 폭. 입력 이벤트마다 불려도 된다(헤드리스·50컬럼 부분합 다시 셈 — 무해). DOM 쓰기는 스케줄러가 프레임당 한 번.
77
+ * 안쪽 ColumnMetrics 는 불변 값이라 부를 때마다 새로 만든다. 받은 폭은 정수 px 로 반올림하고 1 이상으로 든다(끄는 x 가 소수여도 칸 폭은 정수 — 최소 폭은 사용자 끌기 길에만).
78
+ */
79
+ resize(ci: LeafColIndex, width: number): GeometryChange;
80
+ }
81
+ /** 본문 상자의 가로 상태. 그리는 길에서 DOM 을 읽지 않으려고 값으로 넘긴다. width 0 = 모름. */
82
+ export interface ViewportBox {
83
+ readonly scrollLeft: number;
84
+ readonly width: number;
85
+ }
86
+ /** 닫힌 구간 [from, to] (표시 잎 번호, 둘 다 포함). 폭은 spanWidth(from, to − from + 1). */
87
+ export interface WindowSegment {
88
+ readonly from: LeafColIndex;
89
+ readonly to: LeafColIndex;
90
+ }
91
+ /**
92
+ * DOM 으로 둘 컬럼 집합(불변 값). 지금 정책은 「고정 구간 + 연속 구간 하나」만 내지만
93
+ * 소비자는 반드시 segments/gaps 로 순회한다(나중에 구간 여럿을 내도 소비자 무수정).
94
+ * 불변: 고정 컬럼 [0, F-1] 은 늘 포함 · 구간은 겹치지 않고 오름차순 · full 이면 빈칸 없음(지금 DOM 과 같음).
95
+ */
96
+ export interface IColumnWindow {
97
+ /** 이 창을 계산한 표시 잎 컬럼 수(구간·빈칸은 [0, count − 1] 안). */
98
+ readonly count: number;
99
+ readonly full: boolean;
100
+ readonly segments: readonly WindowSegment[];
101
+ contains(ci: LeafColIndex): boolean;
102
+ forEachColumn(fn: (ci: LeafColIndex) => void): void;
103
+ /** 빈칸이 덮을 구간(구간 사이·창 오른쪽 끝 뒤). full 이면 []. */
104
+ gaps(): readonly WindowSegment[];
105
+ equals(other: IColumnWindow): boolean;
106
+ }
107
+ /** 창 계산 입력. */
108
+ export interface WindowQuery {
109
+ readonly box: ViewportBox;
110
+ /** 화면 밖이어도 그릴 컬럼(편집 중·키보드 포커스 직후). */
111
+ readonly pinned: readonly LeafColIndex[];
112
+ }
113
+ /** 이 그리드 상태의 모양(규칙 판정 입력). */
114
+ export interface GridShape {
115
+ readonly autoHeight: boolean;
116
+ readonly viewportWidth: number;
117
+ /** 병합이 하나도 없나 — 창 규칙이 「병합이 있나」를 묻는 유일한 원천(규칙·정책에 병합 원천을 따로 넘기지 않는다). */
118
+ readonly mergeEmpty: boolean;
119
+ readonly virtualColumns: boolean;
120
+ }
121
+ /**
122
+ * 「창을 써도 되나」 규칙 하나. 규칙끼리 서로 모른다. 하나라도 false 면 전 컬럼.
123
+ * 클래스가 아니라 객체 리터럴(id + 함수) 목록 — 조건식이지 종류 가르기가 아니다. id 는 진단용.
124
+ */
125
+ export interface WindowRule {
126
+ readonly id: 'autoHeight' | 'unknownWidth' | 'mergeActive' | 'optOut' | (string & {});
127
+ readonly allowsWindow: (shape: GridShape) => boolean;
128
+ }
129
+ /** 지금 어느 컬럼을 DOM 으로 둘지 정하는 유일한 곳. / Sole owner of the horizontal column window. */
130
+ export interface IColumnWindowPolicy {
131
+ compute(q: WindowQuery, shape: GridShape): IColumnWindow;
132
+ /** 이력: 그려 둔 창이 「보이는 범위 + 여유의 절반」을 아직 덮나. */
133
+ covers(drawn: IColumnWindow, q: WindowQuery): boolean;
134
+ }
135
+ /**
136
+ * 글꼴 지표 — 원천은 기존 `appearance/ResolvedAppearanceSnapshot.ts`(유일한 getComputedStyle 접점, arch 경계 파일).
137
+ * 그 스냅숏은 지금 font{family,size,lineHeight:1.4} 만 준다 → 같은 파일에서 `--og-cell-padding` 을 읽어
138
+ * padX/padY 를 함께 내놓게 더한다(새 getComputedStyle 접점을 만들지 않음). wrap 칸 줄 높이는 1.4 가 아니라 base.css 의 1.35 × fontPx.
139
+ */
140
+ export interface TypeMetrics {
141
+ readonly fontPx: number;
142
+ /**
143
+ * 줄 높이 px. 여러 줄 칸 줄 수 식은 **이 값**을 쓰고, 제공자가 base.css 의 wrap 칸 값 1.35 × fontPx 로 채운다
144
+ * (ResolvedAppearanceSnapshot 의 lineHeight 1.4 는 머리글·한 줄 칸 몫이라 쓰지 않음).
145
+ */
146
+ readonly lineHeightPx: number;
147
+ /** 칸 좌우 안쪽 여백 합(px). */
148
+ readonly padX: number;
149
+ /** 칸 위아래 안쪽 여백 합(px). */
150
+ readonly padY: number;
151
+ }
152
+ export interface TextSpec {
153
+ readonly columnWidth: number;
154
+ /** 본문 보이는 폭(한 줄 칸 덮는 폭의 하한). 0(모름 — jsdom·숨은 컨테이너)이면 limit = Infinity(자르지 않음, 폭 모름 규칙과 같은 뜻). */
155
+ readonly viewportWidth: number;
156
+ /** wrap + 고정 행 높이 칸이면 rowHeight, 아니면 null(한 줄). */
157
+ readonly wrapRowHeight: number | null;
158
+ readonly metrics: TypeMetrics;
159
+ /** autoHeight·상한 끔·template 렌더러 → true(전문). */
160
+ readonly unlimited: boolean;
161
+ }
162
+ /**
163
+ * 칸에 넣을 글자 수 상한과 그 상한이 말줄임을 지켜 주는 최대 폭을 정하는 유일한 곳.
164
+ * 불변: 결과는 원문의 앞부분 · 서로게이트 쌍·결합 문자를 가르지 않음 · 폭 없는 글자가 자를 자리 앞에 있으면 전문.
165
+ */
166
+ export interface ICellTextPolicy {
167
+ /** Infinity = 자르지 않음. */
168
+ limit(spec: TextSpec): number;
169
+ /** 이 상한으로 채운 칸이 말줄임을 유지하는 최대 컬럼 폭(넘으면 다시 채움). */
170
+ coverWidth(limit: number, spec: TextSpec): number;
171
+ /** text 를 limit 에 맞춰 안전하게 자른다(앞부분). */
172
+ fit(text: string, limit: number): string;
173
+ }
174
+ export interface CellRangeLike {
175
+ readonly startRow: number;
176
+ readonly endRow: number;
177
+ readonly startCol: LeafColIndex;
178
+ readonly endCol: LeafColIndex;
179
+ }
180
+ /** 범위 선택 테두리를 칸 DOM 이 아니라 기하·행 번호로 계산(창 밖 모서리·강제 배치 제거). */
181
+ export interface IRangeRectCalculator {
182
+ rect(range: CellRangeLike, scroll: {
183
+ readonly top: number;
184
+ readonly left: number;
185
+ }, rowHeight: number, headerHeight: number): {
186
+ left: number;
187
+ top: number;
188
+ width: number;
189
+ height: number;
190
+ };
191
+ }
192
+ export interface ViewportSample {
193
+ readonly containerH: number;
194
+ /**
195
+ * 머리글 + 페이지 나누기(푸터는 넣지 않는다). 높이가 정해진 경우의 보이는 높이는 지금 식 그대로 containerH − chromeH.
196
+ */
197
+ readonly chromeH: number;
198
+ /** 푸터 높이(없으면 0). 「내용이 높이를 정함」 등식 containerH == chromeH + footerH + contentH + hScrollbarH 에만 든다. */
199
+ readonly footerH: number;
200
+ /** 전체 행 × rowHeight. */
201
+ readonly contentH: number;
202
+ /** 본문 상자 배치 높이(jsdom = 0). */
203
+ readonly bodyLayoutH: number;
204
+ /** 본문 상자의 화면 좌표 top. */
205
+ readonly bodyTop: number;
206
+ /** 창·잘라 보이게 하는 조상들로 깎은 화면 구간(화면 좌표). */
207
+ readonly visibleTop: number;
208
+ readonly visibleBottom: number;
209
+ /** bodyWrap.scrollHeight > clientHeight + 1 */
210
+ readonly bodyScrollable: boolean;
211
+ /**
212
+ * 본문 상자의 가로 스크롤바 높이 = bodyWrap.offsetHeight − clientHeight − 위아래 테두리(윈도 기본 약 17px,
213
+ * 스크롤바를 숨긴 헤드리스 브라우저에서는 0). contentDriven 조건에 더한다.
214
+ */
215
+ readonly hScrollbarH: number;
216
+ /** 옵트인 fallbackViewportHeight(준 경우만). */
217
+ readonly fallbackViewportHeight?: number;
218
+ /** 사용자가 끈 경우(pageVirtualization:false). */
219
+ readonly pageVirtualization: boolean;
220
+ }
221
+ export type ViewportVerdict = {
222
+ readonly kind: 'bounded';
223
+ readonly viewportH: number;
224
+ } | {
225
+ readonly kind: 'legacyClamp';
226
+ readonly viewportH: number;
227
+ }
228
+ /** clip 은 본문 좌표(px). 이 구간 밖 행은 화면에 안 보인다. */
229
+ | {
230
+ readonly kind: 'contentDriven';
231
+ readonly viewportH: number;
232
+ readonly clipTop: number;
233
+ readonly clipBottom: number;
234
+ };
235
+ /** 컨테이너 높이가 정해진 상태인지, 내용이 높이를 정하는 상태인지 판정하는 유일한 곳. */
236
+ export interface IViewportHeightJudge {
237
+ judge(sample: ViewportSample): ViewportVerdict;
238
+ }
239
+ /** 세로 창에 페이지 쪽 잘림을 알려 주는 포트(VirtualScroll 이 구현). */
240
+ export interface IVerticalClipTarget {
241
+ setClip(clip: {
242
+ readonly top: number;
243
+ readonly bottom: number;
244
+ } | null): void;
245
+ }
246
+ /** 행 범위(반열림). */
247
+ export interface RowSpan {
248
+ readonly start: ViewIndex;
249
+ readonly end: ViewIndex;
250
+ }
@@ -40,6 +40,11 @@ export declare const SLICE_OWNERSHIP: {
40
40
  readonly rowHeight: "AppearanceResolver";
41
41
  readonly measured: "MeasurementSeam";
42
42
  readonly selection: "SelectionModel";
43
+ readonly colGeometry: "ColumnGeometry";
44
+ readonly colWindow: "ColumnWindowPolicy";
45
+ readonly renderRequest: "RenderScheduler";
46
+ readonly sortRanks: "SortKeyStore";
47
+ readonly drawnBody: "BodyView";
43
48
  };
44
49
  /** 슬라이스 키. / Slice key. */
45
50
  export type SliceKey = keyof typeof SLICE_OWNERSHIP;
@@ -0,0 +1,50 @@
1
+ import { FooterDefLike, FooterResultLike, FooterSource, FooterValue, IFooterValues } from './ports.js';
2
+ /** 푸터 정의 한 줄(옵션 `footer` 의 원소 꼴 — 계약 꼴에 그리는 쪽이 읽는 맞춤을 더함). / One footer definition. */
3
+ export interface FooterDef extends FooterDefLike {
4
+ readonly align?: string;
5
+ }
6
+ /** 정의 하나의 계산 결과. 필드 이름은 공개 `getFooterData()` 가 돌려주는 모양 그대로. / Result shape exposed by `getFooterData()`. */
7
+ export interface FooterResult extends FooterResultLike {
8
+ _field: string;
9
+ _value: FooterValue;
10
+ _formatted: string;
11
+ }
12
+ /** 사용자 집계 전략: 숫자를 돌려주면 그 값, null 이면 기본 집계. / User aggregate: a number wins, null falls back. */
13
+ export type SummaryOpFn = (op: string, nums: any[], field: string) => number | null;
14
+ /** 확장 지점 조회(그리드의 전략 조회와 같은 꼴). / Strategy lookup, same shape as the grid's. */
15
+ export type StrategyLookup = <F extends Function>(slot: string, fallback: F) => F;
16
+ export interface FooterValuesOptions {
17
+ /** `summaryOp` 슬롯을 찾는 곳. 없으면 사용자 전략 없음. / Where the `summaryOp` slot is resolved. */
18
+ getStrategy?: StrategyLookup;
19
+ }
20
+ /**
21
+ * 푸터 합계 값 계산의 유일한 주인. 상태가 없고 캐시도 없다 — 같은 입력이면 같은 결과, 부를 때마다 다시 셈한다.
22
+ *
23
+ * Sole owner of footer summary values. Stateless and uncached.
24
+ */
25
+ export declare class FooterValues implements IFooterValues {
26
+ private readonly _strategy;
27
+ constructor(opts?: FooterValuesOptions);
28
+ /**
29
+ * 정의마다 결과 하나(field 와 op 가 둘 다 있는 정의만, 정의 순서대로). 정의가 없으면 원천을 읽지 않고 [].
30
+ * 원천은 계산 한 번에 한 번 읽는다.
31
+ *
32
+ * One result per definition that has both field and op, in order. Reads the source once.
33
+ */
34
+ compute(defs: readonly FooterDefLike[] | null | undefined, src: FooterSource): FooterResult[];
35
+ /**
36
+ * 숫자를 표시 글자로. 서식이 없으면 반올림 후 한국 로캘 구분 기호. 서식이 있으면 숫자 토큰 앞뒤의 접두·접미
37
+ * (통화 기호 등)를 떼고, `#`·`,` 가 있으면 천 단위 구분 기호, 소수부 자릿수로 반올림 자리를 정한다.
38
+ *
39
+ * Formats a number for display. No format: rounded, ko-KR separators. With a format: prefix/suffix
40
+ * around the numeric token are kept, `#`/`,` turn on thousands separators, decimals set precision.
41
+ */
42
+ format(value: number, fmt?: string): string;
43
+ /**
44
+ * 정의 하나. 순서를 지금 계산과 같게 둔다: 값 모으기 → 사용자 전략 찾기·부르기 → 개수 → 기본 집계.
45
+ * 순서가 같아야 예외가 나는 자리와 사용자 전략이 받는 값이 같다.
46
+ *
47
+ * One definition, in the same order as before so exceptions and strategy inputs match.
48
+ */
49
+ private _computeOne;
50
+ }
@@ -0,0 +1,31 @@
1
+ /** 합계 계산 입력. */
2
+ export interface FooterSource {
3
+ /** 합계 대상 행(표시 순서 — 순서는 합계에 무관). */
4
+ rows(): readonly unknown[];
5
+ }
6
+ /**
7
+ * 푸터 정의 한 줄 — 옵션 `footer` 의 원소(`types.ts` 의 `FooterDef`)를 구조로 받는다.
8
+ * 집계 칸은 `field`·`op` 가 둘 다 있는 정의뿐이다(어느 하나가 없으면 결과에 나오지 않는다 — 지금 동작).
9
+ */
10
+ export interface FooterDefLike {
11
+ readonly field?: string;
12
+ readonly op?: string;
13
+ readonly format?: string;
14
+ readonly label?: string;
15
+ readonly colspan?: number;
16
+ }
17
+ /** 집계 값(값 없음은 null). */
18
+ export type FooterValue = number | null;
19
+ /** 정의 하나의 결과. 모양은 지금 `FooterManager.computeValues()`·공개 `getFooterData()` 가 돌려주는 그대로. */
20
+ export interface FooterResultLike {
21
+ readonly _field: string;
22
+ readonly _value: FooterValue;
23
+ readonly _formatted: string;
24
+ }
25
+ /**
26
+ * 푸터 합계 값 계산의 유일한 주인(순수 함수 객체). 값은 지금 FooterManager.computeValues 와 같다.
27
+ * 결과는 집계 칸 정의 순서대로 하나씩(정의가 없거나 비면 원천을 읽지 않고 빈 배열). summaryOp 사용자 전략도 지금처럼 매번 부른다.
28
+ */
29
+ export interface IFooterValues {
30
+ compute(defs: readonly FooterDefLike[] | null | undefined, src: FooterSource): readonly FooterResultLike[];
31
+ }
@@ -0,0 +1,17 @@
1
+ import { DrawnState, IRenderPlan, IRenderPlanner, IRenderRequest, NextState, PlannerFeatures } from './ports.js';
2
+ /**
3
+ * 계획을 내는 유일한 곳. 상태를 들지 않는다 — 같은 입력이면 늘 같은 계획(입력은 고치지 않음).
4
+ * 규칙 묶음(`features`)을 하나씩 켜서 빠른 길을 연다. 기본값은 전부 꺼짐 = 모든 요청이 통째(지금 그리는 횟수 그대로).
5
+ * 실행 순서는 계획 계약대로 기하 → 행 → 창 → 다시 채우기 → 나머지.
6
+ *
7
+ * Stateless planner. Features open fast paths one by one; the default (all off) answers every request with a full rebuild.
8
+ */
9
+ export declare class RenderPlanner implements IRenderPlanner {
10
+ private readonly _ratio;
11
+ private readonly _features;
12
+ constructor(opts?: {
13
+ diffMaxRatio?: number;
14
+ features?: Partial<PlannerFeatures>;
15
+ });
16
+ plan(req: IRenderRequest, drawn: DrawnState, next: NextState): IRenderPlan;
17
+ }
@@ -0,0 +1,91 @@
1
+ import { ChangeMask, IRenderRequest, RequestDetail } from './ports.js';
2
+ /**
3
+ * 「무엇이 바뀌었나」 비트 묶음 + 세부. 상태 변경 한 번에 하나 만들고, 스케줄러가 한 프레임 동안 합친다.
4
+ * merge — 교환·결합: changes(OR) · cells(합집합) · widthChangedFrom(작은 쪽) · sync(OR).
5
+ * 나중이 이김: rows · focusTo (null 은 상대를 이기지 못함).
6
+ *
7
+ * Bit set of what changed plus details. merge is commutative/associative except for rows/focusTo (last non-null wins).
8
+ */
9
+ export declare class RenderRequest implements IRenderRequest {
10
+ /** 할 일 없는 요청(합치기의 항등원). / The no-op request (identity of merge). */
11
+ static readonly NONE: RenderRequest;
12
+ /**
13
+ * 보이는 범위를 그 자리에서 통째로 다시 그리라는 요청 — 불변 값이라 하나를 나눠 쓴다(부를 때마다 새로 만들지 않음).
14
+ *
15
+ * Sync full repaint of the visible range; immutable, so one shared value.
16
+ */
17
+ static readonly REPAINT_VISIBLE: RenderRequest;
18
+ /**
19
+ * 본문을 비우라는 요청(자료를 모두 지운 뒤) — 하나를 나눠 쓴다.
20
+ *
21
+ * Sync request that empties the body (after all data is cleared); one shared value.
22
+ */
23
+ static readonly REPAINT_CLEAR: RenderRequest;
24
+ /**
25
+ * 행 선택·체크 상태만 바뀌었다는 요청(값은 그대로) — 하나를 나눠 쓴다. 푸터 값 같은 내용 일은 계획이 거른다.
26
+ *
27
+ * Sync request saying only row selection/check state changed (values unchanged); one shared value. Content work such as footer values is filtered by the plan.
28
+ */
29
+ static readonly ROW_STATE: RenderRequest;
30
+ /**
31
+ * 세로 창 쪽 요청 둘(sync 아님 — 다음 프레임에 하나로 합쳐짐, 범위는 그릴 때 세로 창에 물음):
32
+ * `SCROLLED` 는 스크롤 위치만 바뀜(푸터 값 같은 내용 일은 계획이 거름), `WINDOW_CHANGED` 는 행 수·행 높이·보이는 높이가 바뀜.
33
+ *
34
+ * Two vertical-window requests (not sync — merged into the next frame; the range is asked at paint time):
35
+ * `SCROLLED` = only the scroll position changed, `WINDOW_CHANGED` = row count / row height / viewport height changed.
36
+ */
37
+ static readonly SCROLLED: RenderRequest;
38
+ static readonly WINDOW_CHANGED: RenderRequest;
39
+ readonly changes: ChangeMask;
40
+ readonly detail: Readonly<RequestDetail>;
41
+ private constructor();
42
+ /**
43
+ * 요청을 만든다. 모르는 비트(정의 밖·음수·정수 아님)는 RangeError — 조용히 버리면 그 원인으로는 아무것도 안 그려진다.
44
+ * 세부에 넘긴 배열·객체는 얼린 사본으로 든다.
45
+ *
46
+ * Unknown bits throw RangeError; detail arrays/objects are copied and frozen.
47
+ */
48
+ static of(changes: ChangeMask, detail?: Partial<RequestDetail>): RenderRequest;
49
+ /**
50
+ * 행 범위 [start, endInclusive] 를 그 자리에서 통째로 다시 그리라는 요청. 끝을 포함하는 옛 그리기 범위(묶음 펼침의
51
+ * 전 행 `0..n−1` 등)를 반열림으로 바꿔 담는다 — 값을 자르지 않으므로 `(0, −1)`·`start > end` 도 그대로 지나간다.
52
+ *
53
+ * Sync full repaint of rows [start, endInclusive]; converts the inclusive end to half-open without clamping.
54
+ */
55
+ static rowsInclusive(start: number, endInclusive: number): RenderRequest;
56
+ /** 비트 가운데 하나라도 있나. / True if any of the given bits is set. */
57
+ has(mask: ChangeMask): boolean;
58
+ /** 합치기 규칙은 누적기 하나가 안다 — 값 둘을 합치는 것도 누적기에 차례로 더해 얼린다. / Merging delegates to the accumulator. */
59
+ merge(other: IRenderRequest): RenderRequest;
60
+ }
61
+ /**
62
+ * 요청 합치기 규칙의 유일한 주인 — 고칠 수 있는 누적기. 한 프레임 동안 들어오는 요청을 새 값 없이 더해 두었다가
63
+ * `freeze()` 로 요청 하나를 얼린다(스케줄러가 프레임마다 하나 들고 쓴다; `RenderRequest.merge` 도 이것을 쓴다).
64
+ * 규칙: 비트 OR · 칸 합집합 · `widthChangedFrom` 작은 쪽 · `sync` OR(교환·결합) / `rows`·`focusTo` 는 null 아닌 마지막.
65
+ * 칸: 정규형 배열 둘까지는 그대로 들고 있다가 선형 병합, 셋째부터는 (행, 필드) 열쇠 Map 에 모아 얼릴 때 한 번 정렬 —
66
+ * 값 둘 합치기는 정렬 0, 한 프레임 칸 요청 수천 개도 더하기마다 O(1).
67
+ *
68
+ * Sole owner of the merge rules: a mutable accumulator that adds requests without allocating per add and
69
+ * freezes one request at the end. Up to two canonical cell arrays are linearly merged; beyond that a keyed Map is used.
70
+ */
71
+ export declare class RenderRequestAccumulator {
72
+ private _mask;
73
+ private _focusTo;
74
+ private _widthFrom;
75
+ private _rows;
76
+ private _sync;
77
+ private _pending;
78
+ private _cellsA;
79
+ private _cellsB;
80
+ private _map;
81
+ /** 더한 요청이 하나라도 있나(비트가 0 인 요청도 「있음」). / Whether anything was added since the last freeze. */
82
+ get pending(): boolean;
83
+ add(req: IRenderRequest): this;
84
+ /** 쌓인 것을 요청 하나로 얼리고 비운다. / Freezes the accumulated request and resets. */
85
+ freeze(): RenderRequest;
86
+ /** 버린다(그리드를 지울 때). / Drops everything accumulated. */
87
+ clear(): void;
88
+ private _addCells;
89
+ private _put;
90
+ private _frozenCells;
91
+ }
@@ -0,0 +1,169 @@
1
+ import { IColumnWindow, RowSpan } from '../../coordinate/geometryPorts.js';
2
+ /**
3
+ * 「무엇이 바뀌었나」 비트. 내는 쪽은 자기가 바꾼 것만 말한다. 무엇을 다시 그릴지는 RenderPlanner 혼자 정한다.
4
+ * 처음에는 모든 호출처가 All 로 시작하고 원인별로 하나씩 좁힌다.
5
+ */
6
+ export declare const Change: {
7
+ /** 세로 위치만(행 집합·내용 그대로). */
8
+ readonly RowsScrolled: number;
9
+ /** 가로 위치만. */
10
+ readonly ColsScrolled: number;
11
+ /** 컬럼 폭(끄는 중·놓음·API). 끄는 동안의 쓰기도 이 요청으로 스케줄러를 거친다. */
12
+ readonly ColWidth: number;
13
+ /** 보이는 행의 「무엇」이 바뀜: setData·필터·행 추가/삭제/이동·묶음 펼침. */
14
+ readonly RowSet: number;
15
+ /** 행 집합은 같고 순서만(정렬). 푸터 합계는 안 바뀐다. */
16
+ readonly RowOrder: number;
17
+ /** 선택·체크·행 상태 — 내용 그대로. */
18
+ readonly RowState: number;
19
+ /** 포커스 칸 이동. */
20
+ readonly Focus: number;
21
+ /** 칸 몇 개의 값. */
22
+ readonly CellValue: number;
23
+ /** 범위 선택 면. */
24
+ readonly Range: number;
25
+ /** 컬럼 구성: 숨김·보임·고정·순서·시트 전환·병합 지정. */
26
+ readonly Columns: number;
27
+ /** 컨테이너 크기. */
28
+ readonly Viewport: number;
29
+ /** 테마·스킨·밀도·로케일·마스킹 토글. */
30
+ readonly Appearance: number;
31
+ /** 정렬 표시만(머리글 화살표·aria-sort·눌림/진행). */
32
+ readonly SortIndicator: number;
33
+ /** 지금처럼 통째로(원인을 모를 때의 출발점). */
34
+ readonly All: number;
35
+ };
36
+ export type ChangeMask = number;
37
+ export interface CellPos {
38
+ readonly ri: number;
39
+ readonly ci: number;
40
+ }
41
+ export interface CellKey {
42
+ readonly ri: number;
43
+ readonly field: string;
44
+ }
45
+ /**
46
+ * 명시 행 범위. 지금 코드의 세 갈래를 그대로 표현한다:
47
+ * - null : 보이는 범위(VirtualScroll.getVisibleRange — 지금의 `_doRender(...this._visRange())`)
48
+ * - RowSpan : 그 범위 그대로(지금의 묶음·나무·디테일 `doRenderFull(n) => _doRender(0, n−1)` — 전 행)
49
+ * - 'clear' : 본문을 비우고 끝냄(지금의 MutationService `doRenderFull: () => _doRender(0, −1)`)
50
+ * 동작을 바꾸지 않는 옮기기는 이 뜻을 바꾸지 않는다 — 「.og-row 수 = 지금」이 증거.
51
+ */
52
+ export type ExplicitRows = RowSpan | 'clear' | null;
53
+ export interface RequestDetail {
54
+ /** CellValue 일 때. */
55
+ readonly cells: readonly CellKey[];
56
+ /**
57
+ * Focus 일 때 새 포커스 칸만. 옛 칸은 요청에 싣지 않는다 — 플래너가 DrawnState.focus(그려 둔 포커스 칸)에서 얻는다.
58
+ * 그래서 여러 Focus 요청을 합쳐도 「마지막 칸」 하나면 된다.
59
+ */
60
+ readonly focusTo: CellPos | null;
61
+ /** ColWidth 일 때 바뀐 가장 왼쪽 잎. 진단용 — 계획·반영은 기하의 변화 몫(changesSince)을 쓴다. */
62
+ readonly widthChangedFrom: number | null;
63
+ /** 명시 행 범위(위). 여러 요청을 합치면 null 이 아닌 쪽, 둘 다면 뒤 요청. */
64
+ readonly rows: ExplicitRows;
65
+ /** true = 이 호출이 끝날 때 DOM 이 맞아 있어야 함(공개 API 의 동기 계약 — 그 자리에서 flush). */
66
+ readonly sync: boolean;
67
+ }
68
+ /**
69
+ * 불변 값 객체. changes === 0 이면 할 일 없음.
70
+ * merge 규칙: **교환·결합** = changes(OR) · cells(합집합) · widthChangedFrom(작은 쪽) · sync(OR).
71
+ * **나중 요청이 이김**(순서 있음 — 스케줄러는 제출 순서대로 합침) = rows(단 null 은 상대를 이기지 못함) · focusTo(null 은 상대를 이기지 못함).
72
+ * / Immutable request value; merge is commutative for changes/cells/widthChangedFrom/sync, last-wins for rows/focusTo.
73
+ */
74
+ export interface IRenderRequest {
75
+ readonly changes: ChangeMask;
76
+ readonly detail: Readonly<RequestDetail>;
77
+ has(mask: ChangeMask): boolean;
78
+ merge(other: IRenderRequest): IRenderRequest;
79
+ }
80
+ /** 지금 그려져 있는 상태(BodyView 가 유일하게 앎 — 읽기 전용 스냅숏). */
81
+ export interface DrawnState {
82
+ /** null = 아직 안 그림. 'clear' = 비워 둔 상태. */
83
+ readonly rows: RowSpan | 'clear' | null;
84
+ readonly columns: IColumnWindow | null;
85
+ readonly pinned: {
86
+ readonly editRow: number | null;
87
+ readonly editCol: number | null;
88
+ readonly focusRow: number | null;
89
+ };
90
+ /** 지금 그려 둔 포커스 칸(없으면 null) — Focus 계획의 from. */
91
+ readonly focus: CellPos | null;
92
+ /** 그려진 행 종류에 세로 병합·묶음·나무·디테일·autoHeight 가 있나(행 차분 불가). */
93
+ readonly diffBlocked: boolean;
94
+ /**
95
+ * 컬럼별 「잘린 칸 글자가 말줄임을 지켜 주는 최대 폭」(잘린 칸이 없으면 Infinity).
96
+ * 다시 채우기를 정하는 곳은 RenderPlanner 하나 — 너비 조절 binder 는 묻지 않는다.
97
+ */
98
+ readonly coverWidths: readonly number[];
99
+ }
100
+ /** 이번 프레임에 그려야 할 상태 — RenderScheduler 가 VirtualScroll·ColumnWindowPolicy·ColumnGeometry 에 물어 만든다. */
101
+ export interface NextState {
102
+ readonly rows: RowSpan | 'clear';
103
+ readonly columns: IColumnWindow;
104
+ /** 기하 폭(읽기 전용 뷰 — 사본 아님). 다시 채우기 판정용. */
105
+ readonly columnWidths: readonly number[];
106
+ /** 이 기하 판 이후 바뀐 것을 반영해야 함(스케줄러가 마지막으로 반영한 판). */
107
+ readonly geometryVersion: number;
108
+ readonly appliedGeometryVersion: number;
109
+ }
110
+ /** 행 축 일. */
111
+ export type RowWork = 'none' | 'diff' | 'rebuild' | 'clear';
112
+ /** 창(가로) 축 일. 대각선 스크롤(가로+세로 같은 프레임)은 rows:'diff' + cols:'shift' 둘 다. */
113
+ export type ColWork = 'none' | 'shift';
114
+ export type HeaderWork = 'none' | 'sortIndicator' | 'rebuild';
115
+ /** 푸터: 캐시하지 않는다. 부르는 때를 계획 표가 줄인다 — RowSet·CellValue·All 에서만 'values'. */
116
+ export type FooterWork = 'none' | 'values' | 'rebuild';
117
+ /**
118
+ * 한 프레임에 할 최소 일(불변 값). 실행 순서: geometry → rows → cols → refill → 나머지.
119
+ * rows:'rebuild'|'clear' 면 cols 는 'none'(새로 그릴 때 이미 새 창으로).
120
+ * 불변: 실행 결과 화면 = 같은 자료로 통째로 다시 그린 화면(대조 시험 — 대각선 스크롤 포함).
121
+ */
122
+ export interface IRenderPlan {
123
+ readonly rows: RowWork;
124
+ readonly cols: ColWork;
125
+ readonly header: HeaderWork;
126
+ readonly footer: FooterWork;
127
+ /** 기하 투영 반영(GeometryApplier.applyChange(geometry.changesSince(applied))). */
128
+ readonly geometry: boolean;
129
+ /** 잘린 칸 글자 다시 채우기가 필요한 컬럼 = next.columnWidths[ci] > drawn.coverWidths[ci] 인 창 안 컬럼. */
130
+ readonly refillColumns: readonly number[];
131
+ /** 선택·체크 배경만 다시 칠할 행. */
132
+ readonly rowStateRows: readonly number[];
133
+ /** 포커스 옮김. to 가 null 이면 지울 칸(from)만 있다(새 포커스 칸 없음). */
134
+ readonly focus: {
135
+ readonly from: CellPos | null;
136
+ readonly to: CellPos | null;
137
+ } | null;
138
+ readonly cells: readonly CellKey[];
139
+ /** 범위 덧그림(좌표 계산) 다시. */
140
+ readonly overlay: boolean;
141
+ readonly next: NextState;
142
+ /** 할 일이 하나도 없으면 true(프레임을 그냥 넘김). */
143
+ readonly empty: boolean;
144
+ }
145
+ /**
146
+ * 플래너가 켜고 끄는 규칙 묶음. 꺼진 규칙의 요청은 「통째(rows:'rebuild')」로 떨어진다(안전한 쪽).
147
+ * 처음에는 전부 false(= 지금처럼 통째)이고, 빠른 길을 하나씩 켤 때 배선에서 생성자 인자로 켠다.
148
+ * / Planner feature switches; a disabled rule falls back to a full rebuild (the safe side).
149
+ */
150
+ export interface PlannerFeatures {
151
+ /** SortIndicator·RowOrder 를 머리글 정렬 표시만·창 다시 1번으로(머리글 다시 만들기 0). */
152
+ readonly sortIndicatorOnly: boolean;
153
+ /** 푸터 값을 RowSet·CellValue·All 에서만. */
154
+ readonly footerGating: boolean;
155
+ /** 스크롤 요청에서 그려 둔 범위가 그대로면 할 일 0. */
156
+ readonly scrollSkip: boolean;
157
+ /** ColWidth 를 기하 반영만(+다시 채우기). */
158
+ readonly geometryOnly: boolean;
159
+ /** 가로 창(cols:'shift'). */
160
+ readonly columnWindow: boolean;
161
+ /** 세로 행 차분(rows:'diff'). 검증이 끝나기 전에는 false. */
162
+ readonly rowDiff: boolean;
163
+ /** RowState·Focus·CellValue·Range 를 작은 갱신으로. */
164
+ readonly smallUpdates: boolean;
165
+ }
166
+ /** 요청 + 그려 둔 상태 + 다음 상태 → 최소 계획. 규칙은 표(데이터)로 둔다. DOM 없음. / Request + drawn + next → minimal plan. */
167
+ export interface IRenderPlanner {
168
+ plan(req: IRenderRequest, drawn: DrawnState, next: NextState): IRenderPlan;
169
+ }
@@ -0,0 +1,25 @@
1
+ import { IResizeGesture, ResizeBounds, ResizePhase, ResizeResult } from './ports.js';
2
+ /**
3
+ * 너비 조절 한 번의 상태와 폭 계산의 유일한 주인. DOM·시계를 쓰지 않는다.
4
+ * 불변: dragging 밖에서 move 는 null · move·release·lose 가 내는 폭은 [min, max] — cancel 은 시작 폭(되돌리기라
5
+ * 한계 밖일 수 있음) · 한 제스처에 확정(release|lose)은 많아야 한 번 · 시작 폭은 부르는 쪽이 기하에서 받아 넘긴다 ·
6
+ * 유한수가 아닌 x 는 폭을 바꾸지 않는다(유한수가 아닌 x·시작 폭의 press 는 받지 않음).
7
+ * 폭은 소수 그대로 낸다 — 정수로 드는 일은 기하(ColumnGeometry.resize)가 맡는다.
8
+ *
9
+ * Sole owner of one resize gesture's state and width math; no DOM, no clock.
10
+ */
11
+ export declare class ResizeGesture implements IResizeGesture {
12
+ private _state;
13
+ private readonly _m;
14
+ constructor();
15
+ get phase(): ResizePhase;
16
+ /** 쉼 상태에서는 −1. / −1 while idle. */
17
+ get column(): number;
18
+ press(ci: number, startWidth: number, clientX: number, bounds: ResizeBounds): void;
19
+ move(clientX: number): number | null;
20
+ release(clientX: number): ResizeResult | null;
21
+ cancel(): ResizeResult | null;
22
+ lose(): ResizeResult | null;
23
+ consumeClick(): boolean;
24
+ expireSwallow(): void;
25
+ }