@svgrid/grid 2.2.27 → 2.2.29

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 (248) hide show
  1. package/README.md +199 -199
  2. package/dist/FlexRender.svelte +96 -96
  3. package/dist/GridFooter.svelte +179 -179
  4. package/dist/GridMenus.svelte +782 -734
  5. package/dist/SvAutoComplete.svelte +165 -165
  6. package/dist/SvCalendar.svelte +503 -503
  7. package/dist/SvCarousel.svelte +141 -141
  8. package/dist/SvCheckBox.svelte +101 -101
  9. package/dist/SvColorInput.svelte +181 -181
  10. package/dist/SvComboBox.svelte +275 -275
  11. package/dist/SvContextMenu.svelte +116 -116
  12. package/dist/SvCountryInput.svelte +160 -160
  13. package/dist/SvDrawer.svelte +254 -250
  14. package/dist/SvDropDownList.svelte +374 -374
  15. package/dist/SvDurationInput.svelte +126 -126
  16. package/dist/SvField.svelte +293 -293
  17. package/dist/SvForm.svelte +437 -437
  18. package/dist/SvGrid.controller.svelte.d.ts +14 -1
  19. package/dist/SvGrid.controller.svelte.js +112 -28
  20. package/dist/SvGrid.css +2704 -2723
  21. package/dist/SvGrid.svelte +3361 -3333
  22. package/dist/SvGrid.types.d.ts +20 -5
  23. package/dist/SvGridChart.svelte +1724 -1724
  24. package/dist/SvGridChartPanel.svelte +485 -485
  25. package/dist/SvGridChartView.svelte +70 -70
  26. package/dist/SvGridDropdown.svelte +696 -696
  27. package/dist/SvGridSelect.svelte +259 -259
  28. package/dist/SvGroupCell.svelte +109 -109
  29. package/dist/SvListBox.svelte +326 -287
  30. package/dist/SvListBox.svelte.d.ts +10 -1
  31. package/dist/SvMaskedInput.svelte +122 -122
  32. package/dist/SvMenu.svelte +124 -124
  33. package/dist/SvMenuList.svelte +146 -146
  34. package/dist/SvMultiSelect.svelte +281 -281
  35. package/dist/SvNumberInput.svelte +168 -168
  36. package/dist/SvOtpInput.svelte +158 -158
  37. package/dist/SvPasswordInput.svelte +151 -151
  38. package/dist/SvPhoneInput.svelte +133 -131
  39. package/dist/SvPopover.svelte +197 -197
  40. package/dist/SvRadioGroup.svelte +107 -107
  41. package/dist/SvRowGroupPanel.svelte +170 -170
  42. package/dist/SvScrollArea.svelte +61 -61
  43. package/dist/SvSlider.svelte +200 -200
  44. package/dist/SvSwitchButton.svelte +107 -107
  45. package/dist/SvTagsInput.svelte +112 -112
  46. package/dist/SvTextInput.svelte +147 -147
  47. package/dist/SvTimePicker.svelte +245 -245
  48. package/dist/SvToaster.svelte +159 -159
  49. package/dist/SvToggleButton.svelte +85 -85
  50. package/dist/SvTooltip.svelte +161 -161
  51. package/dist/SvTour.svelte +204 -204
  52. package/dist/SvTree.svelte +437 -437
  53. package/dist/SvTreeSelect.svelte +233 -233
  54. package/dist/cdn/GridMenus-Da_p7SKS.js +486 -0
  55. package/dist/cdn/GridMenus-Ds3OpzZT.js +490 -0
  56. package/dist/cdn/{SvDateTimePicker-B1sDc9Pz.js → SvDateTimePicker-B8GopjhC.js} +2 -2
  57. package/dist/cdn/{SvDateTimePicker-Bh0FTs1E.js → SvDateTimePicker-DB0aIEk8.js} +2 -2
  58. package/dist/cdn/{SvGridChart-Bgk4hDs8.js → SvGridChart-BcLCYvw9.js} +1 -1
  59. package/dist/cdn/{SvGridChart-BKQsO5fZ.js → SvGridChart-BhnFdLd0.js} +1 -1
  60. package/dist/cdn/{SvGridChartPanel-DkCc2Z7b.js → SvGridChartPanel-Cmx9DHAS.js} +1 -1
  61. package/dist/cdn/{SvGridChartPanel-DSkHIQDd.js → SvGridChartPanel-DvjwxLvK.js} +1 -1
  62. package/dist/cdn/{SvGridChartView-BrbVaELm.js → SvGridChartView-B40DTJSX.js} +1 -1
  63. package/dist/cdn/{SvGridChartView-i9rWvSKg.js → SvGridChartView-PwqI4s02.js} +1 -1
  64. package/dist/cdn/{SvGridDropdown-D08sVmAy.js → SvGridDropdown-DjALc_4f.js} +1 -1
  65. package/dist/cdn/{SvGridDropdown-CGxxopQ4.js → SvGridDropdown-hpnHvOGt.js} +1 -1
  66. package/dist/cdn/{src-cgs1wcUS.js → src-BLJfdyL0.js} +4034 -3889
  67. package/dist/cdn/{src-Cw8d9U8j.js → src-DYDCiC0D.js} +7053 -6908
  68. package/dist/cdn/svgrid.js +9 -9
  69. package/dist/cdn/svgrid.svelte-external.js +9 -9
  70. package/dist/chart-export.js +8 -8
  71. package/dist/column-groups.js +8 -10
  72. package/dist/column-id.d.ts +9 -0
  73. package/dist/column-id.js +25 -0
  74. package/dist/core.js +2 -1
  75. package/dist/createListbox.svelte.d.ts +15 -2
  76. package/dist/createListbox.svelte.js +27 -6
  77. package/dist/editing.d.ts +1 -0
  78. package/dist/editing.js +45 -10
  79. package/dist/filtering/excel-filters.d.ts +30 -10
  80. package/dist/filtering/excel-filters.js +96 -15
  81. package/dist/index.d.ts +2 -2
  82. package/dist/index.js +2 -2
  83. package/dist/menus.d.ts +2 -0
  84. package/dist/menus.js +25 -0
  85. package/dist/row-resize.js +40 -0
  86. package/dist/selection.js +1 -1
  87. package/package.json +10 -10
  88. package/src/FlexRender.svelte +96 -96
  89. package/src/GridFooter.svelte +179 -179
  90. package/src/GridMenus.svelte +782 -734
  91. package/src/SvAutoComplete.svelte +165 -165
  92. package/src/SvCalendar.svelte +503 -503
  93. package/src/SvCalendar.test.ts +226 -226
  94. package/src/SvCarousel.svelte +141 -141
  95. package/src/SvCheckBox.svelte +101 -101
  96. package/src/SvColorInput.svelte +181 -181
  97. package/src/SvComboBox.svelte +275 -275
  98. package/src/SvContextMenu.svelte +116 -116
  99. package/src/SvCountryInput.svelte +160 -160
  100. package/src/SvDrawer.svelte +254 -250
  101. package/src/SvDrawer.test.ts +18 -1
  102. package/src/SvDropDownList.svelte +374 -374
  103. package/src/SvDurationInput.svelte +126 -126
  104. package/src/SvField.svelte +293 -293
  105. package/src/SvForm.svelte +437 -437
  106. package/src/SvForm.test.ts +411 -411
  107. package/src/SvGrid.controller.svelte.ts +3335 -3239
  108. package/src/SvGrid.css +2704 -2723
  109. package/src/SvGrid.svelte +3361 -3333
  110. package/src/SvGrid.types.ts +1628 -1613
  111. package/src/SvGridChart.svelte +1724 -1724
  112. package/src/SvGridChartPanel.svelte +485 -485
  113. package/src/SvGridChartView.svelte +70 -70
  114. package/src/SvGridDropdown.svelte +696 -696
  115. package/src/SvGridSelect.svelte +259 -259
  116. package/src/SvGroupCell.svelte +109 -109
  117. package/src/SvListBox.svelte +326 -287
  118. package/src/SvMaskedInput.svelte +122 -122
  119. package/src/SvMenu.svelte +124 -124
  120. package/src/SvMenu.test.ts +97 -97
  121. package/src/SvMenuList.svelte +146 -146
  122. package/src/SvMultiSelect.svelte +281 -281
  123. package/src/SvNavPane.test.ts +15 -4
  124. package/src/SvNumberInput.svelte +168 -168
  125. package/src/SvOtpInput.svelte +158 -158
  126. package/src/SvPasswordInput.svelte +151 -151
  127. package/src/SvPhoneInput.svelte +133 -131
  128. package/src/SvPopover.svelte +197 -197
  129. package/src/SvRadioGroup.svelte +107 -107
  130. package/src/SvRowGroupPanel.svelte +170 -170
  131. package/src/SvScrollArea.svelte +61 -61
  132. package/src/SvSlider.svelte +200 -200
  133. package/src/SvSwitchButton.svelte +107 -107
  134. package/src/SvTagsInput.svelte +112 -112
  135. package/src/SvTextInput.svelte +147 -147
  136. package/src/SvTimePicker.svelte +245 -245
  137. package/src/SvToaster.svelte +159 -159
  138. package/src/SvToaster.test.ts +95 -95
  139. package/src/SvToggleButton.svelte +85 -85
  140. package/src/SvTooltip.svelte +161 -161
  141. package/src/SvTour.svelte +204 -204
  142. package/src/SvTree.svelte +437 -437
  143. package/src/SvTreeSelect.svelte +233 -233
  144. package/src/a11y/dismissable.test.ts +119 -119
  145. package/src/a11y/dismissable.ts +114 -114
  146. package/src/a11y.contract.test.ts +49 -49
  147. package/src/a11y.test.ts +59 -59
  148. package/src/a11y.ts +61 -61
  149. package/src/ai.test.ts +502 -502
  150. package/src/ai.ts +1391 -1391
  151. package/src/build-api.coverage.test.ts +633 -633
  152. package/src/build-api.ts +895 -895
  153. package/src/builtin-editors.grid.test.ts +85 -85
  154. package/src/cell-formatting.ts +169 -169
  155. package/src/cell-render.ts +469 -469
  156. package/src/chart-export.ts +201 -201
  157. package/src/chart-view.svelte.ts +36 -36
  158. package/src/chart.ts +2296 -2296
  159. package/src/collaboration.test.ts +104 -104
  160. package/src/collaboration.ts +167 -167
  161. package/src/column-groups.test.ts +48 -0
  162. package/src/column-groups.ts +8 -10
  163. package/src/column-id.ts +30 -0
  164. package/src/core.performance.test.ts +30 -30
  165. package/src/core.ts +1112 -1111
  166. package/src/createAutocomplete.svelte.ts +132 -132
  167. package/src/createCombobox.svelte.ts +191 -191
  168. package/src/createCountryInput.svelte.ts +157 -157
  169. package/src/createDropdownList.svelte.ts +168 -168
  170. package/src/createForm.svelte.ts +386 -386
  171. package/src/createGrid.svelte.ts +42 -42
  172. package/src/createGrid.test.ts +10 -10
  173. package/src/createGridState.svelte.ts +17 -17
  174. package/src/createListbox.svelte.ts +39 -7
  175. package/src/createMenu.svelte.ts +225 -225
  176. package/src/createPopoverSelect.svelte.ts +213 -213
  177. package/src/createSlider.svelte.ts +191 -191
  178. package/src/createTooltip.svelte.ts +144 -144
  179. package/src/createTree.svelte.ts +319 -319
  180. package/src/editing.test.ts +949 -859
  181. package/src/editing.ts +709 -675
  182. package/src/editor-contract.ts +157 -157
  183. package/src/export-data-api.test.ts +126 -126
  184. package/src/export-format.test.ts +107 -107
  185. package/src/export-format.ts +598 -598
  186. package/src/filter-operators.ts +157 -157
  187. package/src/filtering/excel-filters.test.ts +44 -1
  188. package/src/filtering/excel-filters.ts +91 -14
  189. package/src/flex-render.ts +3 -3
  190. package/src/form-field.ts +127 -127
  191. package/src/index.ts +715 -713
  192. package/src/js-scroller.svelte.ts +173 -173
  193. package/src/keyboard.test.ts +59 -59
  194. package/src/keyboard.ts +97 -97
  195. package/src/list-nav.test.ts +49 -49
  196. package/src/list-nav.ts +29 -29
  197. package/src/list-option.test.ts +56 -56
  198. package/src/list-option.ts +172 -172
  199. package/src/menus.test.ts +736 -700
  200. package/src/menus.ts +679 -652
  201. package/src/merge-objects.ts +48 -48
  202. package/src/overlays.test.ts +90 -90
  203. package/src/render-component.ts +28 -28
  204. package/src/row-resize.test.ts +100 -0
  205. package/src/row-resize.ts +36 -0
  206. package/src/scheduler-model.test.ts +562 -562
  207. package/src/scheduler-model.ts +872 -872
  208. package/src/selection.test.ts +754 -754
  209. package/src/selection.ts +600 -600
  210. package/src/server-data-source.test.ts +289 -289
  211. package/src/server-data-source.ts +413 -413
  212. package/src/sparkline.test.ts +68 -68
  213. package/src/sparkline.ts +169 -169
  214. package/src/spreadsheet.test.ts +489 -489
  215. package/src/spreadsheet.ts +312 -312
  216. package/src/static-functions.ts +11 -11
  217. package/src/subscribe.ts +38 -38
  218. package/src/svgrid-wrapper.types.ts +524 -524
  219. package/src/svgrid.api-extensions.test.ts +8 -3
  220. package/src/svgrid.behavior.test.ts +706 -706
  221. package/src/svgrid.cell-dom-ids.test.ts +96 -0
  222. package/src/svgrid.charting.test.ts +534 -534
  223. package/src/svgrid.conditional-stat-scope.test.ts +111 -0
  224. package/src/svgrid.features.test.ts +157 -157
  225. package/src/svgrid.filter-menu-listbox.svelte.test.ts +308 -0
  226. package/src/svgrid.filter-menu-scroll.test.ts +3 -1
  227. package/src/svgrid.group-header-ids.test.ts +121 -0
  228. package/src/svgrid.new-features.wrapper.test.ts +251 -251
  229. package/src/svgrid.wrapper.test.ts +40 -40
  230. package/src/test-setup.ts +62 -62
  231. package/src/themes/index.ts +215 -215
  232. package/src/toast-store.svelte.ts +246 -246
  233. package/src/toast-store.test.ts +147 -147
  234. package/src/ui-buttons.test.ts +144 -144
  235. package/src/ui-inputs.test.ts +118 -118
  236. package/src/ui-range.test.ts +70 -70
  237. package/src/ui-selection.test.ts +155 -155
  238. package/src/ui-tier1.test.ts +142 -142
  239. package/src/virtual.test.ts +88 -88
  240. package/src/virtualization/column-virtualizer.test.ts +27 -27
  241. package/src/virtualization/column-virtualizer.ts +30 -30
  242. package/src/virtualization/svelte-virtualizer.svelte.ts +26 -26
  243. package/src/virtualization/types.ts +30 -30
  244. package/src/virtualization/virtualizer.test.ts +47 -47
  245. package/src/virtualization/virtualizer.ts +296 -296
  246. package/themes/ember.css +71 -71
  247. package/dist/cdn/GridMenus-BzxEYNtW.js +0 -421
  248. package/dist/cdn/GridMenus-Dr-nGEXn.js +0 -417
package/src/menus.ts CHANGED
@@ -1,652 +1,679 @@
1
- // menus handlers extracted from the controller. Imperative event handlers
2
- // reading/writing controller state via the `ctx` handle; the reactive core
3
- // ($state/$derived/$effect) stays in the controller.
4
- import {
5
- applyExcelFilter,
6
- normalizeForFilter,
7
- createColumnVirtualizer,
8
- createCoreRowModel,
9
- createExpandedRowModel,
10
- createFilteredRowModel,
11
- createGroupedRowModel,
12
- createPaginatedRowModel,
13
- createSvelteVirtualizer,
14
- createSortedRowModel,
15
- createSvGrid,
16
- filterFns,
17
- getGridCellA11yProps,
18
- getGridCellDomId,
19
- getGridHeaderA11yProps,
20
- getGridRootA11yProps,
21
- getGridRowA11yProps,
22
- parseEditorValue,
23
- normalizeEditorOptions,
24
- sortFns,
25
- tableFeatures,
26
- rowSortingFeature,
27
- columnFilteringFeature,
28
- columnGroupingFeature,
29
- type CellContext,
30
- type EditorContext,
31
- type CellEditorOption,
32
- type CellEditorType,
33
- type CellFormatter,
34
- type CellFormatConfig,
35
- type Column,
36
- type ColumnDef,
37
- type Row,
38
- type RowData,
39
- type SvGridApi,
40
- type TableFeatures,
41
- } from "./index";
42
- import "./sv-grid-scrollbar";
43
- import { untrack } from "svelte";
44
- import type { Snippet } from "svelte";
45
- import { getKeyboardIntent, getNextActiveCell } from "./keyboard";
46
- import {
47
- formatNumericWithConfig,
48
- getDateFormatter,
49
- resolveDatePattern,
50
- } from "./cell-formatting";
51
- import {
52
- RenderSnippetConfig,
53
- RenderComponentConfig,
54
- } from "./render-component";
55
- import { buildFillPattern } from "./fill-patterns";
56
- import { buildSparkline, toSparklineValues } from "./sparkline";
57
- import {
58
- resolveCellFormat,
59
- computeColumnStat,
60
- formatsNeedingStats,
61
- type ColumnStat,
62
- type ResolvedCellFormat,
63
- } from "./conditional-formatting";
64
- import SvGridDropdown from "./SvGridDropdown.svelte";
65
- import type {
66
- Props,
67
- SelectionPoint,
68
- SelectionRange,
69
- CellEditState,
70
- FilterOperator,
71
- FilterOption,
72
- MenuPosition,
73
- } from "./SvGrid.types";
74
- import {
75
- cfTextStyle,
76
- fmtStat,
77
- getCellKey,
78
- resolveClassList,
79
- toDateInputValue,
80
- toDateTimeLocalInputValue,
81
- getEditableInputValue,
82
- getEditorInputType,
83
- toValueArray,
84
- getOptionLabel,
85
- getOptionColor,
86
- colorfulChipStyle,
87
- getEditorClass,
88
- asDate,
89
- clampMenuX,
90
- cssEscape,
91
- rawToNumber,
92
- formatFacetNumber,
93
- formatFacetDate,
94
- } from "./SvGrid.helpers";
95
- import { createCellRender } from "./cell-render";
96
- import { createEditing } from "./editing";
97
- import { createSelection } from "./selection";
98
- import { createColumns } from "./columns";
99
- import { createGridApi } from "./build-api";
100
- import { createClipboard } from "./clipboard";
101
- import {
102
- filterOperatorOptions,
103
- fallbackOperatorOption,
104
- TEXT_OPERATORS,
105
- NUMBER_OPERATORS,
106
- DATE_OPERATORS,
107
- CHECKBOX_OPERATORS,
108
- operatorOption,
109
- operatorsForColumn,
110
- defaultOperatorFor,
111
- operatorLabelFor,
112
- } from "./filter-operators";
113
- import {
114
- type FacetBucket,
115
- isBucketableColumn,
116
- buildBuckets,
117
- isInBucket,
118
- } from "./facet-buckets";
119
- import { splitInTokens, joinInTokens } from "./filtering/excel-filters";
120
- import {
121
- getColumnBaseValue,
122
- isGroupRow,
123
- toolPanelHeaderLabel,
124
- formatSummaryNumeric,
125
- getColumnAlign,
126
- getPinnedCellValue,
127
- getColumnAccessorValue,
128
- columnDefMatchesId,
129
- } from "./cell-values";
130
-
131
- export function createMenus<
132
- TFeatures extends TableFeatures = TableFeatures,
133
- TData extends RowData = RowData,
134
- >(ctx: any) {
135
- function updateFilterRow(columnId: string, value: string) {
136
- ctx.filterRowValues = { ...ctx.filterRowValues, [columnId]: value };
137
- const current = ctx.filterMenuValues[columnId] ?? {
138
- operator: "contains" as const,
139
- value: "",
140
- };
141
- ctx.filterMenuValues = {
142
- ...ctx.filterMenuValues,
143
- [columnId]: { ...current, value },
144
- };
145
- }
146
-
147
- function updateFilterOperator(columnId: string, operator: FilterOperator) {
148
- const current = ctx.filterMenuValues[columnId] ?? {
149
- operator: "contains" as const,
150
- value: "",
151
- };
152
- ctx.filterMenuValues = {
153
- ...ctx.filterMenuValues,
154
- [columnId]: { ...current, operator },
155
- };
156
- }
157
-
158
- function updateFilterMenuValue(columnId: string, value: string) {
159
- const current = ctx.filterMenuValues[columnId] ?? {
160
- operator: "contains" as const,
161
- value: "",
162
- };
163
- ctx.filterMenuValues = {
164
- ...ctx.filterMenuValues,
165
- [columnId]: { ...current, value },
166
- };
167
- ctx.filterRowValues = { ...ctx.filterRowValues, [columnId]: value };
168
- }
169
-
170
- /** Upper-bound input for the `between` operator. Only relevant when
171
- * the column's current operator is `between`; harmless to call
172
- * otherwise. */
173
- function updateFilterMenuValueTo(columnId: string, valueTo: string) {
174
- const current = ctx.filterMenuValues[columnId] ?? {
175
- operator: "between" as const,
176
- value: "",
177
- };
178
- ctx.filterMenuValues = {
179
- ...ctx.filterMenuValues,
180
- [columnId]: { ...current, valueTo },
181
- };
182
- }
183
-
184
- /** Current `in` / `notIn` token list for a column (from the filter-row value). */
185
- function filterTokens(columnId: string): string[] {
186
- return splitInTokens(ctx.filterRowValues[columnId] ?? "");
187
- }
188
-
189
- /** Add a value to a column's `in` / `notIn` list (no-op if already present). */
190
- function addFilterToken(columnId: string, token: string) {
191
- const t = token.trim();
192
- if (!t) return;
193
- const tokens = filterTokens(columnId);
194
- if (!tokens.includes(t)) tokens.push(t);
195
- updateFilterRow(columnId, joinInTokens(tokens));
196
- }
197
-
198
- /** Remove a value from a column's `in` / `notIn` list. */
199
- function removeFilterToken(columnId: string, token: string) {
200
- updateFilterRow(
201
- columnId,
202
- joinInTokens(filterTokens(columnId).filter((t) => t !== token)),
203
- );
204
- }
205
-
206
- /** Toggle a value in a column's `in` / `notIn` list (checklist behaviour). */
207
- function toggleFilterToken(columnId: string, token: string) {
208
- if (filterTokens(columnId).includes(token)) removeFilterToken(columnId, token);
209
- else addFilterToken(columnId, token);
210
- }
211
-
212
- function toggleCheckboxWithKeyboard(
213
- event: KeyboardEvent,
214
- toggle: () => void,
215
- ) {
216
- if (event.key !== "Enter" && event.key !== " ") return;
217
- event.preventDefault();
218
- toggle();
219
- }
220
-
221
- function isColumnFiltered(columnId: string) {
222
- if (ctx.valueFilters[columnId]) return true;
223
- const menuFilter = ctx.filterMenuValues[columnId];
224
- return Boolean(
225
- menuFilter &&
226
- (menuFilter.operator === "isBlank" ||
227
- menuFilter.operator === "isNotBlank" ||
228
- menuFilter.value.trim()),
229
- );
230
- }
231
-
232
- function closeMenus() {
233
- ctx.columnMenuFor = null;
234
- ctx.filterMenuFor = null;
235
- ctx.operatorMenuFor = null;
236
- ctx.inSuggestFor = null;
237
- ctx.chooseColumnsPos = null;
238
- }
239
-
240
- /** Open the `in` / `notIn` value-suggestions dropdown under a chip input. */
241
- function openInSuggest(anchor: HTMLElement, columnId: string) {
242
- const rect = anchor.getBoundingClientRect();
243
- ctx.inSuggestPos = { x: clampMenuX(rect.left, 220), y: rect.bottom + 4 };
244
- ctx.inSuggestQuery = "";
245
- ctx.inSuggestFor = columnId;
246
- }
247
-
248
- function closeInSuggest() {
249
- ctx.inSuggestFor = null;
250
- ctx.inSuggestQuery = "";
251
- }
252
-
253
- function openChooseColumns(event: MouseEvent) {
254
- event.stopPropagation();
255
- // Submenu behavior: keep the parent operations menu open and float the
256
- // Choose Columns panel out to the right of it (AG-Grid style). Falls
257
- // back to below the item if the popover would clip the viewport.
258
- const trigger = event.currentTarget as HTMLElement;
259
- const menuEl = trigger.closest(".sv-grid-menu") as HTMLElement | null;
260
- const anchor = (menuEl ?? trigger).getBoundingClientRect();
261
- const panelWidth = 240;
262
- const wantRight = anchor.right + 4;
263
- const x =
264
- wantRight + panelWidth + 8 > window.innerWidth
265
- ? clampMenuX(anchor.left - panelWidth - 4, panelWidth)
266
- : clampMenuX(wantRight, panelWidth);
267
- ctx.chooseColumnsPos = { x, y: anchor.top };
268
- }
269
-
270
- function openColumnMenu(event: MouseEvent, columnId: string) {
271
- event.stopPropagation();
272
- const wasOpen = ctx.columnMenuFor === columnId;
273
- closeMenus();
274
- if (wasOpen) return;
275
- const rect = (event.currentTarget as HTMLElement).getBoundingClientRect();
276
- ctx.columnMenuPos = {
277
- x: clampMenuX(rect.right - 240, 240),
278
- y: rect.bottom + 4,
279
- };
280
- ctx.columnMenuTab = "general";
281
- ctx.columnMenuFor = columnId;
282
- }
283
-
284
- function openFilterMenu(event: MouseEvent, columnId: string) {
285
- event.stopPropagation();
286
- const wasOpen = ctx.filterMenuFor === columnId;
287
- closeMenus();
288
- if (wasOpen) return;
289
-
290
- // If the consumer is running in row-mode (or any mode where the
291
- // funnel popover wouldn't render), redirect the click to the
292
- // inline filter input for this column. Without this the funnel
293
- // would be a dead button - it visibly clicks but nothing happens
294
- // because the menu is gated behind `showColumnFiltersEffective`.
295
- if (!ctx.showColumnFiltersEffective && ctx.showFilterRowEffective) {
296
- // Find the row-mode filter input and focus it. The input is
297
- // tagged with `data-svgrid-filter-col` so we can target by id
298
- // without depending on column position.
299
- const input = (ctx.scrollContainer as HTMLElement | null)?.querySelector<HTMLInputElement>(
300
- `[data-svgrid-filter-col="${cssEscape(columnId)}"]`,
301
- );
302
- if (input) {
303
- input.focus();
304
- input.select();
305
- // Brief pulse so the user sees where focus landed.
306
- input.classList.add("sv-grid-filter-value-pulse");
307
- setTimeout(() => input.classList.remove("sv-grid-filter-value-pulse"), 700);
308
- }
309
- return;
310
- }
311
-
312
- const rect = (event.currentTarget as HTMLElement).getBoundingClientRect();
313
- ctx.filterMenuPos = {
314
- x: clampMenuX(rect.right - 260, 260),
315
- y: rect.bottom + 4,
316
- };
317
- ctx.columnMenuSearch = "";
318
- ctx.filterMenuFor = columnId;
319
- }
320
-
321
- function openOperatorMenu(event: MouseEvent, columnId: string) {
322
- event.stopPropagation();
323
- const wasOpen = ctx.operatorMenuFor === columnId;
324
- closeMenus();
325
- if (wasOpen) return;
326
- const rect = (event.currentTarget as HTMLElement).getBoundingClientRect();
327
- ctx.operatorMenuPos = { x: clampMenuX(rect.left, 184), y: rect.bottom + 4 };
328
- ctx.operatorMenuFor = columnId;
329
- }
330
-
331
- function sortColumnFromMenu(columnId: string, desc: boolean) {
332
- ctx.grid.store.setState((prev: any) => ({
333
- ...prev,
334
- sorting: [{ id: columnId, desc }],
335
- }));
336
- closeMenus();
337
- }
338
-
339
- function clearColumnSort(columnId: string) {
340
- ctx.grid.store.setState((prev: any) => ({
341
- ...prev,
342
- sorting: (prev.sorting ?? []).filter(
343
- (entry: { id: string }) => entry.id !== columnId,
344
- ),
345
- }));
346
- closeMenus();
347
- }
348
-
349
- function groupByColumnFromMenu(columnId: string) {
350
- const current = ctx.grid.getState().grouping ?? [];
351
- if (current.includes(columnId)) {
352
- closeMenus();
353
- return;
354
- }
355
- ctx.grid.setGrouping([...current, columnId]);
356
- closeMenus();
357
- }
358
-
359
- function clearGroupingFromMenu(columnId: string) {
360
- const current = ctx.grid.getState().grouping ?? [];
361
- ctx.grid.setGrouping(current.filter((id: string) => id !== columnId));
362
- closeMenus();
363
- }
364
-
365
- function isFacetChecked(columnId: string, value: string) {
366
- const selected = ctx.valueFilters[columnId];
367
- return selected ? selected.has(value) : true;
368
- }
369
-
370
- function toggleFacetValue(columnId: string, value: string) {
371
- const allValues = ctx.columnMenuFacetValues;
372
- const next = new Set(ctx.valueFilters[columnId] ?? allValues);
373
- if (next.has(value)) next.delete(value);
374
- else next.add(value);
375
- if (next.size === allValues.length) {
376
- const copy = { ...ctx.valueFilters };
377
- delete copy[columnId];
378
- ctx.valueFilters = copy;
379
- } else {
380
- ctx.valueFilters = { ...ctx.valueFilters, [columnId]: next };
381
- }
382
- }
383
-
384
- function isAllFacetsChecked(columnId: string) {
385
- const selected = ctx.valueFilters[columnId];
386
- return !selected || selected.size >= ctx.columnMenuFacetValues.length;
387
- }
388
-
389
- function toggleAllFacets(columnId: string) {
390
- if (isAllFacetsChecked(columnId)) {
391
- ctx.valueFilters = { ...ctx.valueFilters, [columnId]: new Set<string>() };
392
- } else {
393
- const copy = { ...ctx.valueFilters };
394
- delete copy[columnId];
395
- ctx.valueFilters = copy;
396
- }
397
- }
398
-
399
- function clearColumnFilter(columnId: string) {
400
- // `untrack`: read-modify-write on the filter maps. Keeps the method safe to
401
- // call from a consumer's reactive `$effect` (e.g. via `api.clearFilter`)
402
- // without capturing these reads as a dependency and looping. See
403
- // `build-api`'s `setFilter` for the full rationale.
404
- untrack(() => {
405
- if (ctx.valueFilters[columnId]) {
406
- const next = { ...ctx.valueFilters };
407
- delete next[columnId];
408
- ctx.valueFilters = next;
409
- }
410
- if (ctx.filterMenuValues[columnId]) {
411
- const next = { ...ctx.filterMenuValues };
412
- delete next[columnId];
413
- ctx.filterMenuValues = next;
414
- }
415
- if (ctx.filterRowValues[columnId]) {
416
- const next = { ...ctx.filterRowValues };
417
- delete next[columnId];
418
- ctx.filterRowValues = next;
419
- }
420
- });
421
- }
422
-
423
- // External pagination is controlled: emit the requested page/size and let
424
- // the consumer fetch + update props. Never mutate local pagination state.
425
- function emitExternalPagination(pageIndex: number, pageSize: number): boolean {
426
- if (ctx.props.externalPagination !== true) return false;
427
- ctx.props.onPaginationChange?.({ pageIndex: Math.max(0, pageIndex), pageSize });
428
- ctx.scrollContainer?.scrollTo?.({ top: 0 });
429
- return true;
430
- }
431
-
432
- function changePage(delta: number) {
433
- if (
434
- emitExternalPagination(
435
- (ctx.props.pageIndex ?? 0) + delta,
436
- ctx.props.pageSize ?? 10,
437
- )
438
- )
439
- return;
440
- ctx.grid.setPagination((prev: any) => ({
441
- ...prev,
442
- pageIndex: Math.max((prev?.pageIndex ?? 0) + delta, 0),
443
- }));
444
- ctx.scrollContainer?.scrollTo?.({ top: 0 });
445
- }
446
-
447
- function goToPage(pageIndex: number) {
448
- if (emitExternalPagination(pageIndex, ctx.props.pageSize ?? 10)) return;
449
- ctx.grid.setPagination((prev: any) => ({
450
- ...prev,
451
- pageIndex: Math.max(0, pageIndex),
452
- }));
453
- ctx.scrollContainer?.scrollTo?.({ top: 0 });
454
- }
455
-
456
- function setPageSize(pageSize: number) {
457
- // External mode: changing page size resets to the first page.
458
- if (emitExternalPagination(0, pageSize)) return;
459
- ctx.grid.setPagination((prev: any) => {
460
- const oldSize = prev?.pageSize ?? 10;
461
- const oldIndex = prev?.pageIndex ?? 0;
462
- // Keep the first visible row in view when the page size changes.
463
- const firstVisibleRow = oldIndex * oldSize;
464
- return {
465
- ...prev,
466
- pageSize,
467
- pageIndex: Math.max(0, Math.floor(firstVisibleRow / pageSize)),
468
- };
469
- });
470
- }
471
-
472
- // ---- Right-click context menu --------------------------------------
473
- type CtxTarget = { rowIndex: number; colIndex: number; columnId: string; rowId: string; row: TData | null };
474
- type ResolvedItem = { key: string; label: string; separator?: boolean; disabled?: boolean; run?: () => void };
475
-
476
- function insertRowAt(t: CtxTarget, offset: number) {
477
- const data = ctx.internalData.slice() as TData[];
478
- const idx = t.row ? data.indexOf(t.row) : -1;
479
- const at = idx < 0 ? data.length : idx + offset;
480
- data.splice(at, 0, {} as TData);
481
- ctx.internalData = data;
482
- }
483
- function removeRowAt(t: CtxTarget) {
484
- if (!t.row) return;
485
- ctx.internalData = (ctx.internalData as TData[]).filter((r) => r !== t.row);
486
- }
487
- function removeColAt(t: CtxTarget) {
488
- ctx.internalColumns = ctx.internalColumns.filter(
489
- (d: any) => (d.id ?? d.field) !== t.columnId,
490
- );
491
- }
492
-
493
- // Built-in items, keyed. `run` reads the live target passed at click time.
494
- // `msg` names the GridMessages key so the label localizes (falls back to the
495
- // English `label` when no `localeText` is set).
496
- const builtins: Record<string, { label: string; msg?: string; run: (t: CtxTarget) => void }> = {
497
- copy: { label: "Copy", msg: "menuCopy", run: () => ctx.copySelectionToClipboard() },
498
- cut: { label: "Cut", msg: "menuCut", run: () => ctx.cutSelectionToClipboard() },
499
- paste: { label: "Paste", msg: "menuPaste", run: () => void ctx.pasteFromClipboard() },
500
- clear: { label: "Clear", msg: "menuClear", run: () => ctx.clearSelectedCells() },
501
- row_above: { label: "Insert row above", msg: "menuInsertRowAbove", run: (t) => insertRowAt(t, 0) },
502
- row_below: { label: "Insert row below", msg: "menuInsertRowBelow", run: (t) => insertRowAt(t, 1) },
503
- remove_row: { label: "Remove row", msg: "menuRemoveRow", run: removeRowAt },
504
- remove_col: { label: "Remove column", msg: "menuRemoveColumn", run: removeColAt },
505
- comment: { label: "Edit comment", msg: "menuEditComment", run: (t) => openCommentEditor(t) },
506
- // Charting: open the chart panel scoped to the current cell selection. Gated
507
- // on `chartingEnabled` in the resolver below.
508
- chart: { label: "Chart selected range", msg: "chartRange", run: () => { ctx.chartPanelOpen = true; } },
509
- };
510
- const DEFAULT_ITEMS = [
511
- "copy", "cut", "paste", "clear", "separator",
512
- "row_above", "row_below", "remove_row", "separator", "remove_col",
513
- ];
514
-
515
- function openContextMenu(
516
- event: MouseEvent,
517
- rowIndex: number,
518
- colIndex: number,
519
- columnId: string,
520
- ) {
521
- if (!ctx.props.contextMenu) return;
522
- event.preventDefault();
523
- closeMenus();
524
- ctx.contextMenuFor = null;
525
- const rowModel = ctx.allRows[rowIndex];
526
- const row = rowModel?.original ?? null;
527
- const rowId = rowModel?.id ?? String(rowIndex);
528
- // Reserve ~280px for the menu body. If the click is in the bottom third,
529
- // flip the menu above the cursor so it stays fully in the viewport.
530
- const menuHeight = 280;
531
- const y = event.clientY + menuHeight > window.innerHeight
532
- ? Math.max(8, event.clientY - menuHeight)
533
- : event.clientY;
534
- ctx.contextMenuPos = {
535
- x: clampMenuX(event.clientX, 220),
536
- y,
537
- };
538
- ctx.contextMenuFor = { rowIndex, colIndex, columnId, rowId, row };
539
- }
540
-
541
- function closeContextMenu() {
542
- ctx.contextMenuFor = null;
543
- }
544
-
545
- // ---- Editable comments ---------------------------------------------
546
- function openCommentEditor(t: CtxTarget) {
547
- const cur =
548
- ctx.noteOverrides?.[t.rowId]?.[t.columnId] ??
549
- ctx.props.notes?.[t.rowId]?.[t.columnId] ??
550
- "";
551
- ctx.commentDraft = cur;
552
- ctx.commentEditFor = { rowId: t.rowId, columnId: t.columnId, x: ctx.contextMenuPos.x, y: ctx.contextMenuPos.y };
553
- ctx.contextMenuFor = null;
554
- }
555
- function writeNote(rowId: string, columnId: string, note: string) {
556
- const next = { ...ctx.noteOverrides };
557
- next[rowId] = { ...(next[rowId] ?? {}), [columnId]: note };
558
- ctx.noteOverrides = next;
559
- ctx.props.onNoteChange?.({ rowId, columnId, note });
560
- }
561
- function saveComment() {
562
- const e = ctx.commentEditFor;
563
- if (!e) return;
564
- writeNote(e.rowId, e.columnId, ctx.commentDraft);
565
- ctx.commentEditFor = null;
566
- }
567
- function removeComment() {
568
- const e = ctx.commentEditFor;
569
- if (!e) return;
570
- writeNote(e.rowId, e.columnId, "");
571
- ctx.commentEditFor = null;
572
- }
573
- function closeCommentEditor() {
574
- ctx.commentEditFor = null;
575
- }
576
-
577
- /** Resolve the configured items against the current target for rendering. */
578
- function contextMenuItems(): ResolvedItem[] {
579
- const target = ctx.contextMenuFor as CtxTarget | null;
580
- if (!target) return [];
581
- const cfg = ctx.props.contextMenu;
582
- const messages = ctx.messages;
583
- const entries: any[] = Array.isArray(cfg)
584
- ? cfg
585
- : [
586
- ...DEFAULT_ITEMS,
587
- ...(ctx.chartingEnabled ? ["separator", "chart"] : []),
588
- ...(ctx.props.editableComments ? ["separator", "comment"] : []),
589
- ];
590
- const out: ResolvedItem[] = [];
591
- for (const entry of entries) {
592
- if (entry === "separator") { out.push({ key: "sep" + out.length, label: "", separator: true }); continue; }
593
- if (typeof entry === "string") {
594
- // The chart item only makes sense when charting is enabled.
595
- if (entry === "chart" && !ctx.chartingEnabled) continue;
596
- const b = builtins[entry];
597
- if (!b) continue;
598
- const label = (b.msg && messages?.[b.msg]) || b.label;
599
- out.push({ key: entry, label, run: () => b.run(target) });
600
- continue;
601
- }
602
- if (entry.hidden?.(target)) continue;
603
- out.push({
604
- key: entry.key,
605
- label: entry.label,
606
- disabled: entry.disabled?.(target) ?? false,
607
- run: () => entry.action(target),
608
- });
609
- }
610
- // Drop leading/trailing/double separators.
611
- return out.filter((it, i, a) =>
612
- !it.separator || (i > 0 && i < a.length - 1 && !a[i - 1]?.separator),
613
- );
614
- }
615
-
616
- return {
617
- updateFilterRow,
618
- updateFilterOperator,
619
- updateFilterMenuValue,
620
- updateFilterMenuValueTo,
621
- addFilterToken,
622
- removeFilterToken,
623
- toggleFilterToken,
624
- toggleCheckboxWithKeyboard,
625
- isColumnFiltered,
626
- closeMenus,
627
- openInSuggest,
628
- closeInSuggest,
629
- openChooseColumns,
630
- openColumnMenu,
631
- openFilterMenu,
632
- openOperatorMenu,
633
- sortColumnFromMenu,
634
- clearColumnSort,
635
- groupByColumnFromMenu,
636
- clearGroupingFromMenu,
637
- isFacetChecked,
638
- toggleFacetValue,
639
- isAllFacetsChecked,
640
- toggleAllFacets,
641
- clearColumnFilter,
642
- changePage,
643
- goToPage,
644
- setPageSize,
645
- openContextMenu,
646
- closeContextMenu,
647
- contextMenuItems,
648
- saveComment,
649
- removeComment,
650
- closeCommentEditor,
651
- };
652
- }
1
+ // menus handlers extracted from the controller. Imperative event handlers
2
+ // reading/writing controller state via the `ctx` handle; the reactive core
3
+ // ($state/$derived/$effect) stays in the controller.
4
+ import {
5
+ applyExcelFilter,
6
+ normalizeForFilter,
7
+ createColumnVirtualizer,
8
+ createCoreRowModel,
9
+ createExpandedRowModel,
10
+ createFilteredRowModel,
11
+ createGroupedRowModel,
12
+ createPaginatedRowModel,
13
+ createSvelteVirtualizer,
14
+ createSortedRowModel,
15
+ createSvGrid,
16
+ filterFns,
17
+ getGridCellA11yProps,
18
+ getGridCellDomId,
19
+ getGridHeaderA11yProps,
20
+ getGridRootA11yProps,
21
+ getGridRowA11yProps,
22
+ parseEditorValue,
23
+ normalizeEditorOptions,
24
+ sortFns,
25
+ tableFeatures,
26
+ rowSortingFeature,
27
+ columnFilteringFeature,
28
+ columnGroupingFeature,
29
+ type CellContext,
30
+ type EditorContext,
31
+ type CellEditorOption,
32
+ type CellEditorType,
33
+ type CellFormatter,
34
+ type CellFormatConfig,
35
+ type Column,
36
+ type ColumnDef,
37
+ type Row,
38
+ type RowData,
39
+ type SvGridApi,
40
+ type TableFeatures,
41
+ } from "./index";
42
+ import "./sv-grid-scrollbar";
43
+ import { untrack } from "svelte";
44
+ import type { Snippet } from "svelte";
45
+ import { getKeyboardIntent, getNextActiveCell } from "./keyboard";
46
+ import {
47
+ formatNumericWithConfig,
48
+ getDateFormatter,
49
+ resolveDatePattern,
50
+ } from "./cell-formatting";
51
+ import {
52
+ RenderSnippetConfig,
53
+ RenderComponentConfig,
54
+ } from "./render-component";
55
+ import { buildFillPattern } from "./fill-patterns";
56
+ import { buildSparkline, toSparklineValues } from "./sparkline";
57
+ import {
58
+ resolveCellFormat,
59
+ computeColumnStat,
60
+ formatsNeedingStats,
61
+ type ColumnStat,
62
+ type ResolvedCellFormat,
63
+ } from "./conditional-formatting";
64
+ import SvGridDropdown from "./SvGridDropdown.svelte";
65
+ import type {
66
+ Props,
67
+ SelectionPoint,
68
+ SelectionRange,
69
+ CellEditState,
70
+ FilterOperator,
71
+ FilterOption,
72
+ MenuPosition,
73
+ } from "./SvGrid.types";
74
+ import {
75
+ cfTextStyle,
76
+ fmtStat,
77
+ getCellKey,
78
+ resolveClassList,
79
+ toDateInputValue,
80
+ toDateTimeLocalInputValue,
81
+ getEditableInputValue,
82
+ getEditorInputType,
83
+ toValueArray,
84
+ getOptionLabel,
85
+ getOptionColor,
86
+ colorfulChipStyle,
87
+ getEditorClass,
88
+ asDate,
89
+ clampMenuX,
90
+ cssEscape,
91
+ rawToNumber,
92
+ formatFacetNumber,
93
+ formatFacetDate,
94
+ } from "./SvGrid.helpers";
95
+ import { createCellRender } from "./cell-render";
96
+ import { createEditing } from "./editing";
97
+ import { createSelection } from "./selection";
98
+ import { createColumns } from "./columns";
99
+ import { createGridApi } from "./build-api";
100
+ import { createClipboard } from "./clipboard";
101
+ import {
102
+ filterOperatorOptions,
103
+ fallbackOperatorOption,
104
+ TEXT_OPERATORS,
105
+ NUMBER_OPERATORS,
106
+ DATE_OPERATORS,
107
+ CHECKBOX_OPERATORS,
108
+ operatorOption,
109
+ operatorsForColumn,
110
+ defaultOperatorFor,
111
+ operatorLabelFor,
112
+ } from "./filter-operators";
113
+ import {
114
+ type FacetBucket,
115
+ isBucketableColumn,
116
+ buildBuckets,
117
+ isInBucket,
118
+ } from "./facet-buckets";
119
+ import { splitInTokens, joinInTokens } from "./filtering/excel-filters";
120
+ import {
121
+ getColumnBaseValue,
122
+ isGroupRow,
123
+ toolPanelHeaderLabel,
124
+ formatSummaryNumeric,
125
+ getColumnAlign,
126
+ getPinnedCellValue,
127
+ getColumnAccessorValue,
128
+ columnDefMatchesId,
129
+ } from "./cell-values";
130
+
131
+ export function createMenus<
132
+ TFeatures extends TableFeatures = TableFeatures,
133
+ TData extends RowData = RowData,
134
+ >(ctx: any) {
135
+ function updateFilterRow(columnId: string, value: string) {
136
+ ctx.filterRowValues = { ...ctx.filterRowValues, [columnId]: value };
137
+ const current = ctx.filterMenuValues[columnId] ?? {
138
+ operator: "contains" as const,
139
+ value: "",
140
+ };
141
+ ctx.filterMenuValues = {
142
+ ...ctx.filterMenuValues,
143
+ [columnId]: { ...current, value },
144
+ };
145
+ }
146
+
147
+ function updateFilterOperator(columnId: string, operator: FilterOperator) {
148
+ const current = ctx.filterMenuValues[columnId] ?? {
149
+ operator: "contains" as const,
150
+ value: "",
151
+ };
152
+ ctx.filterMenuValues = {
153
+ ...ctx.filterMenuValues,
154
+ [columnId]: { ...current, operator },
155
+ };
156
+ }
157
+
158
+ function updateFilterMenuValue(columnId: string, value: string) {
159
+ const current = ctx.filterMenuValues[columnId] ?? {
160
+ operator: "contains" as const,
161
+ value: "",
162
+ };
163
+ ctx.filterMenuValues = {
164
+ ...ctx.filterMenuValues,
165
+ [columnId]: { ...current, value },
166
+ };
167
+ ctx.filterRowValues = { ...ctx.filterRowValues, [columnId]: value };
168
+ }
169
+
170
+ /** Upper-bound input for the `between` operator. Only relevant when
171
+ * the column's current operator is `between`; harmless to call
172
+ * otherwise. */
173
+ function updateFilterMenuValueTo(columnId: string, valueTo: string) {
174
+ const current = ctx.filterMenuValues[columnId] ?? {
175
+ operator: "between" as const,
176
+ value: "",
177
+ };
178
+ ctx.filterMenuValues = {
179
+ ...ctx.filterMenuValues,
180
+ [columnId]: { ...current, valueTo },
181
+ };
182
+ }
183
+
184
+ /** Current `in` / `notIn` token list for a column (from the filter-row value). */
185
+ function filterTokens(columnId: string): string[] {
186
+ return splitInTokens(ctx.filterRowValues[columnId] ?? "");
187
+ }
188
+
189
+ /** Add a value to a column's `in` / `notIn` list (no-op if already present). */
190
+ function addFilterToken(columnId: string, token: string) {
191
+ const t = token.trim();
192
+ if (!t) return;
193
+ const tokens = filterTokens(columnId);
194
+ if (!tokens.includes(t)) tokens.push(t);
195
+ updateFilterRow(columnId, joinInTokens(tokens));
196
+ }
197
+
198
+ /** Remove a value from a column's `in` / `notIn` list. */
199
+ function removeFilterToken(columnId: string, token: string) {
200
+ updateFilterRow(
201
+ columnId,
202
+ joinInTokens(filterTokens(columnId).filter((t) => t !== token)),
203
+ );
204
+ }
205
+
206
+ /** Toggle a value in a column's `in` / `notIn` list (checklist behaviour). */
207
+ function toggleFilterToken(columnId: string, token: string) {
208
+ if (filterTokens(columnId).includes(token)) removeFilterToken(columnId, token);
209
+ else addFilterToken(columnId, token);
210
+ }
211
+
212
+ /**
213
+ * Replace a column's `in` / `notIn` list wholesale. The suggestions dropdown
214
+ * hands back the full token set after a click, which keeps tokens the user
215
+ * typed by hand (or that the search box is currently hiding) intact.
216
+ */
217
+ function setFilterTokens(columnId: string, tokens: Iterable<string>) {
218
+ const list = [...tokens].map((t) => t.trim()).filter(Boolean);
219
+ updateFilterRow(columnId, joinInTokens(list));
220
+ }
221
+
222
+ function toggleCheckboxWithKeyboard(
223
+ event: KeyboardEvent,
224
+ toggle: () => void,
225
+ ) {
226
+ if (event.key !== "Enter" && event.key !== " ") return;
227
+ event.preventDefault();
228
+ toggle();
229
+ }
230
+
231
+ function isColumnFiltered(columnId: string) {
232
+ if (ctx.valueFilters[columnId]) return true;
233
+ const menuFilter = ctx.filterMenuValues[columnId];
234
+ return Boolean(
235
+ menuFilter &&
236
+ (menuFilter.operator === "isBlank" ||
237
+ menuFilter.operator === "isNotBlank" ||
238
+ menuFilter.value.trim()),
239
+ );
240
+ }
241
+
242
+ function closeMenus() {
243
+ ctx.columnMenuFor = null;
244
+ ctx.filterMenuFor = null;
245
+ ctx.operatorMenuFor = null;
246
+ ctx.inSuggestFor = null;
247
+ ctx.chooseColumnsPos = null;
248
+ }
249
+
250
+ /** Open the `in` / `notIn` value-suggestions dropdown under a chip input. */
251
+ function openInSuggest(anchor: HTMLElement, columnId: string) {
252
+ const rect = anchor.getBoundingClientRect();
253
+ ctx.inSuggestPos = { x: clampMenuX(rect.left, 220), y: rect.bottom + 4 };
254
+ ctx.inSuggestQuery = "";
255
+ ctx.inSuggestFor = columnId;
256
+ }
257
+
258
+ function closeInSuggest() {
259
+ ctx.inSuggestFor = null;
260
+ ctx.inSuggestQuery = "";
261
+ }
262
+
263
+ function openChooseColumns(event: MouseEvent) {
264
+ event.stopPropagation();
265
+ // Submenu behavior: keep the parent operations menu open and float the
266
+ // Choose Columns panel out to the right of it (AG-Grid style). Falls
267
+ // back to below the item if the popover would clip the viewport.
268
+ const trigger = event.currentTarget as HTMLElement;
269
+ const menuEl = trigger.closest(".sv-grid-menu") as HTMLElement | null;
270
+ const anchor = (menuEl ?? trigger).getBoundingClientRect();
271
+ const panelWidth = 240;
272
+ const wantRight = anchor.right + 4;
273
+ const x =
274
+ wantRight + panelWidth + 8 > window.innerWidth
275
+ ? clampMenuX(anchor.left - panelWidth - 4, panelWidth)
276
+ : clampMenuX(wantRight, panelWidth);
277
+ ctx.chooseColumnsPos = { x, y: anchor.top };
278
+ }
279
+
280
+ function openColumnMenu(event: MouseEvent, columnId: string) {
281
+ event.stopPropagation();
282
+ const wasOpen = ctx.columnMenuFor === columnId;
283
+ closeMenus();
284
+ if (wasOpen) return;
285
+ const rect = (event.currentTarget as HTMLElement).getBoundingClientRect();
286
+ ctx.columnMenuPos = {
287
+ x: clampMenuX(rect.right - 240, 240),
288
+ y: rect.bottom + 4,
289
+ };
290
+ ctx.columnMenuTab = "general";
291
+ ctx.columnMenuFor = columnId;
292
+ }
293
+
294
+ function openFilterMenu(event: MouseEvent, columnId: string) {
295
+ event.stopPropagation();
296
+ const wasOpen = ctx.filterMenuFor === columnId;
297
+ closeMenus();
298
+ if (wasOpen) return;
299
+
300
+ // If the consumer is running in row-mode (or any mode where the
301
+ // funnel popover wouldn't render), redirect the click to the
302
+ // inline filter input for this column. Without this the funnel
303
+ // would be a dead button - it visibly clicks but nothing happens
304
+ // because the menu is gated behind `showColumnFiltersEffective`.
305
+ if (!ctx.showColumnFiltersEffective && ctx.showFilterRowEffective) {
306
+ // Find the row-mode filter input and focus it. The input is
307
+ // tagged with `data-svgrid-filter-col` so we can target by id
308
+ // without depending on column position.
309
+ const input = (ctx.scrollContainer as HTMLElement | null)?.querySelector<HTMLInputElement>(
310
+ `[data-svgrid-filter-col="${cssEscape(columnId)}"]`,
311
+ );
312
+ if (input) {
313
+ input.focus();
314
+ input.select();
315
+ // Brief pulse so the user sees where focus landed.
316
+ input.classList.add("sv-grid-filter-value-pulse");
317
+ setTimeout(() => input.classList.remove("sv-grid-filter-value-pulse"), 700);
318
+ }
319
+ return;
320
+ }
321
+
322
+ const rect = (event.currentTarget as HTMLElement).getBoundingClientRect();
323
+ ctx.filterMenuPos = {
324
+ x: clampMenuX(rect.right - 260, 260),
325
+ y: rect.bottom + 4,
326
+ };
327
+ ctx.columnMenuSearch = "";
328
+ ctx.filterMenuFor = columnId;
329
+ }
330
+
331
+ function openOperatorMenu(event: MouseEvent, columnId: string) {
332
+ event.stopPropagation();
333
+ const wasOpen = ctx.operatorMenuFor === columnId;
334
+ closeMenus();
335
+ if (wasOpen) return;
336
+ const rect = (event.currentTarget as HTMLElement).getBoundingClientRect();
337
+ ctx.operatorMenuPos = { x: clampMenuX(rect.left, 184), y: rect.bottom + 4 };
338
+ ctx.operatorMenuFor = columnId;
339
+ }
340
+
341
+ function sortColumnFromMenu(columnId: string, desc: boolean) {
342
+ ctx.grid.store.setState((prev: any) => ({
343
+ ...prev,
344
+ sorting: [{ id: columnId, desc }],
345
+ }));
346
+ closeMenus();
347
+ }
348
+
349
+ function clearColumnSort(columnId: string) {
350
+ ctx.grid.store.setState((prev: any) => ({
351
+ ...prev,
352
+ sorting: (prev.sorting ?? []).filter(
353
+ (entry: { id: string }) => entry.id !== columnId,
354
+ ),
355
+ }));
356
+ closeMenus();
357
+ }
358
+
359
+ function groupByColumnFromMenu(columnId: string) {
360
+ const current = ctx.grid.getState().grouping ?? [];
361
+ if (current.includes(columnId)) {
362
+ closeMenus();
363
+ return;
364
+ }
365
+ ctx.grid.setGrouping([...current, columnId]);
366
+ closeMenus();
367
+ }
368
+
369
+ function clearGroupingFromMenu(columnId: string) {
370
+ const current = ctx.grid.getState().grouping ?? [];
371
+ ctx.grid.setGrouping(current.filter((id: string) => id !== columnId));
372
+ closeMenus();
373
+ }
374
+
375
+ function isFacetChecked(columnId: string, value: string) {
376
+ const selected = ctx.valueFilters[columnId];
377
+ return selected ? selected.has(value) : true;
378
+ }
379
+
380
+ function toggleFacetValue(columnId: string, value: string) {
381
+ const allValues = ctx.columnMenuFacetValues;
382
+ const next = new Set(ctx.valueFilters[columnId] ?? allValues);
383
+ if (next.has(value)) next.delete(value);
384
+ else next.add(value);
385
+ if (next.size === allValues.length) {
386
+ const copy = { ...ctx.valueFilters };
387
+ delete copy[columnId];
388
+ ctx.valueFilters = copy;
389
+ } else {
390
+ ctx.valueFilters = { ...ctx.valueFilters, [columnId]: next };
391
+ }
392
+ }
393
+
394
+ /**
395
+ * Replace a column's checked-facet set. "Everything checked" is stored as an
396
+ * ABSENT entry (so an unfiltered high-cardinality column never holds a set of
397
+ * every value), which is why the full-size case deletes instead of writing.
398
+ */
399
+ function setFacetSelection(columnId: string, next: ReadonlySet<string>) {
400
+ if (next.size >= ctx.columnMenuFacetValues.length) {
401
+ const copy = { ...ctx.valueFilters };
402
+ delete copy[columnId];
403
+ ctx.valueFilters = copy;
404
+ return;
405
+ }
406
+ ctx.valueFilters = { ...ctx.valueFilters, [columnId]: new Set(next) };
407
+ }
408
+
409
+ function isAllFacetsChecked(columnId: string) {
410
+ const selected = ctx.valueFilters[columnId];
411
+ return !selected || selected.size >= ctx.columnMenuFacetValues.length;
412
+ }
413
+
414
+ function toggleAllFacets(columnId: string) {
415
+ if (isAllFacetsChecked(columnId)) {
416
+ ctx.valueFilters = { ...ctx.valueFilters, [columnId]: new Set<string>() };
417
+ } else {
418
+ const copy = { ...ctx.valueFilters };
419
+ delete copy[columnId];
420
+ ctx.valueFilters = copy;
421
+ }
422
+ }
423
+
424
+ function clearColumnFilter(columnId: string) {
425
+ // `untrack`: read-modify-write on the filter maps. Keeps the method safe to
426
+ // call from a consumer's reactive `$effect` (e.g. via `api.clearFilter`)
427
+ // without capturing these reads as a dependency and looping. See
428
+ // `build-api`'s `setFilter` for the full rationale.
429
+ untrack(() => {
430
+ if (ctx.valueFilters[columnId]) {
431
+ const next = { ...ctx.valueFilters };
432
+ delete next[columnId];
433
+ ctx.valueFilters = next;
434
+ }
435
+ if (ctx.filterMenuValues[columnId]) {
436
+ const next = { ...ctx.filterMenuValues };
437
+ delete next[columnId];
438
+ ctx.filterMenuValues = next;
439
+ }
440
+ if (ctx.filterRowValues[columnId]) {
441
+ const next = { ...ctx.filterRowValues };
442
+ delete next[columnId];
443
+ ctx.filterRowValues = next;
444
+ }
445
+ });
446
+ }
447
+
448
+ // External pagination is controlled: emit the requested page/size and let
449
+ // the consumer fetch + update props. Never mutate local pagination state.
450
+ function emitExternalPagination(pageIndex: number, pageSize: number): boolean {
451
+ if (ctx.props.externalPagination !== true) return false;
452
+ ctx.props.onPaginationChange?.({ pageIndex: Math.max(0, pageIndex), pageSize });
453
+ ctx.scrollContainer?.scrollTo?.({ top: 0 });
454
+ return true;
455
+ }
456
+
457
+ function changePage(delta: number) {
458
+ if (
459
+ emitExternalPagination(
460
+ (ctx.props.pageIndex ?? 0) + delta,
461
+ ctx.props.pageSize ?? 10,
462
+ )
463
+ )
464
+ return;
465
+ ctx.grid.setPagination((prev: any) => ({
466
+ ...prev,
467
+ pageIndex: Math.max((prev?.pageIndex ?? 0) + delta, 0),
468
+ }));
469
+ ctx.scrollContainer?.scrollTo?.({ top: 0 });
470
+ }
471
+
472
+ function goToPage(pageIndex: number) {
473
+ if (emitExternalPagination(pageIndex, ctx.props.pageSize ?? 10)) return;
474
+ ctx.grid.setPagination((prev: any) => ({
475
+ ...prev,
476
+ pageIndex: Math.max(0, pageIndex),
477
+ }));
478
+ ctx.scrollContainer?.scrollTo?.({ top: 0 });
479
+ }
480
+
481
+ function setPageSize(pageSize: number) {
482
+ // External mode: changing page size resets to the first page.
483
+ if (emitExternalPagination(0, pageSize)) return;
484
+ ctx.grid.setPagination((prev: any) => {
485
+ const oldSize = prev?.pageSize ?? 10;
486
+ const oldIndex = prev?.pageIndex ?? 0;
487
+ // Keep the first visible row in view when the page size changes.
488
+ const firstVisibleRow = oldIndex * oldSize;
489
+ return {
490
+ ...prev,
491
+ pageSize,
492
+ pageIndex: Math.max(0, Math.floor(firstVisibleRow / pageSize)),
493
+ };
494
+ });
495
+ }
496
+
497
+ // ---- Right-click context menu --------------------------------------
498
+ type CtxTarget = { rowIndex: number; colIndex: number; columnId: string; rowId: string; row: TData | null };
499
+ type ResolvedItem = { key: string; label: string; separator?: boolean; disabled?: boolean; run?: () => void };
500
+
501
+ function insertRowAt(t: CtxTarget, offset: number) {
502
+ const data = ctx.internalData.slice() as TData[];
503
+ const idx = t.row ? data.indexOf(t.row) : -1;
504
+ const at = idx < 0 ? data.length : idx + offset;
505
+ data.splice(at, 0, {} as TData);
506
+ ctx.internalData = data;
507
+ }
508
+ function removeRowAt(t: CtxTarget) {
509
+ if (!t.row) return;
510
+ ctx.internalData = (ctx.internalData as TData[]).filter((r) => r !== t.row);
511
+ }
512
+ function removeColAt(t: CtxTarget) {
513
+ ctx.internalColumns = ctx.internalColumns.filter(
514
+ (d: any) => (d.id ?? d.field) !== t.columnId,
515
+ );
516
+ }
517
+
518
+ // Built-in items, keyed. `run` reads the live target passed at click time.
519
+ // `msg` names the GridMessages key so the label localizes (falls back to the
520
+ // English `label` when no `localeText` is set).
521
+ const builtins: Record<string, { label: string; msg?: string; run: (t: CtxTarget) => void }> = {
522
+ copy: { label: "Copy", msg: "menuCopy", run: () => ctx.copySelectionToClipboard() },
523
+ cut: { label: "Cut", msg: "menuCut", run: () => ctx.cutSelectionToClipboard() },
524
+ paste: { label: "Paste", msg: "menuPaste", run: () => void ctx.pasteFromClipboard() },
525
+ clear: { label: "Clear", msg: "menuClear", run: () => ctx.clearSelectedCells() },
526
+ row_above: { label: "Insert row above", msg: "menuInsertRowAbove", run: (t) => insertRowAt(t, 0) },
527
+ row_below: { label: "Insert row below", msg: "menuInsertRowBelow", run: (t) => insertRowAt(t, 1) },
528
+ remove_row: { label: "Remove row", msg: "menuRemoveRow", run: removeRowAt },
529
+ remove_col: { label: "Remove column", msg: "menuRemoveColumn", run: removeColAt },
530
+ comment: { label: "Edit comment", msg: "menuEditComment", run: (t) => openCommentEditor(t) },
531
+ // Charting: open the chart panel scoped to the current cell selection. Gated
532
+ // on `chartingEnabled` in the resolver below.
533
+ chart: { label: "Chart selected range", msg: "chartRange", run: () => { ctx.chartPanelOpen = true; } },
534
+ };
535
+ const DEFAULT_ITEMS = [
536
+ "copy", "cut", "paste", "clear", "separator",
537
+ "row_above", "row_below", "remove_row", "separator", "remove_col",
538
+ ];
539
+
540
+ function openContextMenu(
541
+ event: MouseEvent,
542
+ rowIndex: number,
543
+ colIndex: number,
544
+ columnId: string,
545
+ ) {
546
+ if (!ctx.props.contextMenu) return;
547
+ event.preventDefault();
548
+ closeMenus();
549
+ ctx.contextMenuFor = null;
550
+ const rowModel = ctx.allRows[rowIndex];
551
+ const row = rowModel?.original ?? null;
552
+ const rowId = rowModel?.id ?? String(rowIndex);
553
+ // Reserve ~280px for the menu body. If the click is in the bottom third,
554
+ // flip the menu above the cursor so it stays fully in the viewport.
555
+ const menuHeight = 280;
556
+ const y = event.clientY + menuHeight > window.innerHeight
557
+ ? Math.max(8, event.clientY - menuHeight)
558
+ : event.clientY;
559
+ ctx.contextMenuPos = {
560
+ x: clampMenuX(event.clientX, 220),
561
+ y,
562
+ };
563
+ ctx.contextMenuFor = { rowIndex, colIndex, columnId, rowId, row };
564
+ }
565
+
566
+ function closeContextMenu() {
567
+ ctx.contextMenuFor = null;
568
+ }
569
+
570
+ // ---- Editable comments ---------------------------------------------
571
+ function openCommentEditor(t: CtxTarget) {
572
+ const cur =
573
+ ctx.noteOverrides?.[t.rowId]?.[t.columnId] ??
574
+ ctx.props.notes?.[t.rowId]?.[t.columnId] ??
575
+ "";
576
+ ctx.commentDraft = cur;
577
+ ctx.commentEditFor = { rowId: t.rowId, columnId: t.columnId, x: ctx.contextMenuPos.x, y: ctx.contextMenuPos.y };
578
+ ctx.contextMenuFor = null;
579
+ }
580
+ function writeNote(rowId: string, columnId: string, note: string) {
581
+ const next = { ...ctx.noteOverrides };
582
+ next[rowId] = { ...(next[rowId] ?? {}), [columnId]: note };
583
+ ctx.noteOverrides = next;
584
+ ctx.props.onNoteChange?.({ rowId, columnId, note });
585
+ }
586
+ function saveComment() {
587
+ const e = ctx.commentEditFor;
588
+ if (!e) return;
589
+ writeNote(e.rowId, e.columnId, ctx.commentDraft);
590
+ ctx.commentEditFor = null;
591
+ }
592
+ function removeComment() {
593
+ const e = ctx.commentEditFor;
594
+ if (!e) return;
595
+ writeNote(e.rowId, e.columnId, "");
596
+ ctx.commentEditFor = null;
597
+ }
598
+ function closeCommentEditor() {
599
+ ctx.commentEditFor = null;
600
+ }
601
+
602
+ /** Resolve the configured items against the current target for rendering. */
603
+ function contextMenuItems(): ResolvedItem[] {
604
+ const target = ctx.contextMenuFor as CtxTarget | null;
605
+ if (!target) return [];
606
+ const cfg = ctx.props.contextMenu;
607
+ const messages = ctx.messages;
608
+ const entries: any[] = Array.isArray(cfg)
609
+ ? cfg
610
+ : [
611
+ ...DEFAULT_ITEMS,
612
+ ...(ctx.chartingEnabled ? ["separator", "chart"] : []),
613
+ ...(ctx.props.editableComments ? ["separator", "comment"] : []),
614
+ ];
615
+ const out: ResolvedItem[] = [];
616
+ for (const entry of entries) {
617
+ if (entry === "separator") { out.push({ key: "sep" + out.length, label: "", separator: true }); continue; }
618
+ if (typeof entry === "string") {
619
+ // The chart item only makes sense when charting is enabled.
620
+ if (entry === "chart" && !ctx.chartingEnabled) continue;
621
+ const b = builtins[entry];
622
+ if (!b) continue;
623
+ const label = (b.msg && messages?.[b.msg]) || b.label;
624
+ out.push({ key: entry, label, run: () => b.run(target) });
625
+ continue;
626
+ }
627
+ if (entry.hidden?.(target)) continue;
628
+ out.push({
629
+ key: entry.key,
630
+ label: entry.label,
631
+ disabled: entry.disabled?.(target) ?? false,
632
+ run: () => entry.action(target),
633
+ });
634
+ }
635
+ // Drop leading/trailing/double separators.
636
+ return out.filter((it, i, a) =>
637
+ !it.separator || (i > 0 && i < a.length - 1 && !a[i - 1]?.separator),
638
+ );
639
+ }
640
+
641
+ return {
642
+ updateFilterRow,
643
+ updateFilterOperator,
644
+ updateFilterMenuValue,
645
+ updateFilterMenuValueTo,
646
+ addFilterToken,
647
+ removeFilterToken,
648
+ toggleFilterToken,
649
+ toggleCheckboxWithKeyboard,
650
+ isColumnFiltered,
651
+ closeMenus,
652
+ openInSuggest,
653
+ closeInSuggest,
654
+ openChooseColumns,
655
+ openColumnMenu,
656
+ openFilterMenu,
657
+ openOperatorMenu,
658
+ sortColumnFromMenu,
659
+ clearColumnSort,
660
+ groupByColumnFromMenu,
661
+ clearGroupingFromMenu,
662
+ isFacetChecked,
663
+ toggleFacetValue,
664
+ setFacetSelection,
665
+ setFilterTokens,
666
+ isAllFacetsChecked,
667
+ toggleAllFacets,
668
+ clearColumnFilter,
669
+ changePage,
670
+ goToPage,
671
+ setPageSize,
672
+ openContextMenu,
673
+ closeContextMenu,
674
+ contextMenuItems,
675
+ saveComment,
676
+ removeComment,
677
+ closeCommentEditor,
678
+ };
679
+ }