@svgrid/grid 2.6.22 → 2.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 (331) hide show
  1. package/CHANGELOG.md +88 -88
  2. package/README.md +199 -199
  3. package/dist/FlexRender.svelte +96 -96
  4. package/dist/GridFooter.svelte +181 -181
  5. package/dist/GridMenus.svelte +184 -6
  6. package/dist/SvAutoComplete.svelte +169 -165
  7. package/dist/SvAvatar.svelte +75 -75
  8. package/dist/SvCalendar.svelte +503 -503
  9. package/dist/SvCarousel.svelte +141 -141
  10. package/dist/SvCheckBox.svelte +102 -102
  11. package/dist/SvCircularProgress.svelte +109 -109
  12. package/dist/SvColorInput.svelte +181 -181
  13. package/dist/SvComboBox.svelte +279 -275
  14. package/dist/SvContextMenu.svelte +116 -116
  15. package/dist/SvCountryInput.svelte +163 -163
  16. package/dist/SvDateRangeInput.svelte +25 -3
  17. package/dist/SvDrawer.svelte +254 -254
  18. package/dist/SvDropDownList.svelte +378 -374
  19. package/dist/SvDurationInput.svelte +126 -126
  20. package/dist/SvField.svelte +293 -293
  21. package/dist/SvForm.svelte +437 -437
  22. package/dist/SvGrid.controller.svelte.d.ts +48 -1
  23. package/dist/SvGrid.controller.svelte.js +214 -52
  24. package/dist/SvGrid.css +221 -0
  25. package/dist/SvGrid.helpers.d.ts +55 -0
  26. package/dist/SvGrid.helpers.js +83 -0
  27. package/dist/SvGrid.svelte +145 -0
  28. package/dist/SvGrid.types.d.ts +105 -0
  29. package/dist/SvGridCellEditor.svelte +744 -662
  30. package/dist/SvGridChart.svelte +1716 -1716
  31. package/dist/SvGridChartPanel.svelte +485 -485
  32. package/dist/SvGridChartView.svelte +70 -70
  33. package/dist/SvGridDropdown.svelte +728 -728
  34. package/dist/SvGridSelect.svelte +270 -266
  35. package/dist/SvGridSelect.svelte.d.ts +1 -1
  36. package/dist/SvGroupCell.svelte +116 -116
  37. package/dist/SvListBox.svelte +334 -326
  38. package/dist/SvMaskedInput.svelte +122 -122
  39. package/dist/SvMenu.svelte +124 -124
  40. package/dist/SvMenuList.svelte +146 -146
  41. package/dist/SvMultiSelect.svelte +293 -289
  42. package/dist/SvMultiSelect.svelte.d.ts +1 -1
  43. package/dist/SvNumberInput.svelte +172 -168
  44. package/dist/SvOtpInput.svelte +158 -158
  45. package/dist/SvPasswordInput.svelte +151 -151
  46. package/dist/SvPhoneInput.svelte +133 -133
  47. package/dist/SvPopover.svelte +197 -197
  48. package/dist/SvProgress.svelte +116 -116
  49. package/dist/SvRadioGroup.svelte +107 -107
  50. package/dist/SvRating.svelte +112 -112
  51. package/dist/SvResult.svelte +73 -73
  52. package/dist/SvRichCell.svelte +125 -0
  53. package/dist/SvRichCell.svelte.d.ts +15 -0
  54. package/dist/SvRichText.svelte +211 -211
  55. package/dist/SvRowGroupPanel.svelte +170 -170
  56. package/dist/SvScrollArea.svelte +61 -61
  57. package/dist/SvSlider.svelte +203 -203
  58. package/dist/SvSwitchButton.svelte +108 -108
  59. package/dist/SvTagsInput.svelte +115 -115
  60. package/dist/SvTextArea.svelte +5 -1
  61. package/dist/SvTextInput.svelte +147 -147
  62. package/dist/SvTimePicker.svelte +245 -245
  63. package/dist/SvToaster.svelte +159 -159
  64. package/dist/SvToggleButton.svelte +85 -85
  65. package/dist/SvTooltip.svelte +161 -161
  66. package/dist/SvTour.svelte +208 -208
  67. package/dist/SvTree.svelte +444 -444
  68. package/dist/SvTreeSelect.svelte +239 -235
  69. package/dist/SvTreeSelect.svelte.d.ts +1 -1
  70. package/dist/builtin-editors.d.ts +2 -2
  71. package/dist/builtin-editors.js +19 -3
  72. package/dist/cdn/GridMenus-C4oLsJyj.js +600 -0
  73. package/dist/cdn/GridMenus-yEivjNwl.js +601 -0
  74. package/dist/cdn/SvDateRangeInput-Bh0A0JkF.js +199 -0
  75. package/dist/cdn/SvDateRangeInput-DflbiP7N.js +198 -0
  76. package/dist/cdn/SvDateTimePicker-BWwpfB_o.js +812 -0
  77. package/dist/cdn/SvDateTimePicker-Bivn8dAP.js +816 -0
  78. package/dist/cdn/SvGridCellEditor-AXL8cHGO.js +550 -0
  79. package/dist/cdn/SvGridCellEditor-Ba7rY3eu.js +549 -0
  80. package/dist/cdn/{SvGridChart-BwVos976.js → SvGridChart-Bs2GIR2Q.js} +1 -1
  81. package/dist/cdn/{SvGridChart-BEJmNNx9.js → SvGridChart-CwhFz7GV.js} +1 -1
  82. package/dist/cdn/{SvGridChartPanel-BOknOkrP.js → SvGridChartPanel-1WXuStzM.js} +1 -1
  83. package/dist/cdn/{SvGridChartPanel-D2PjII4O.js → SvGridChartPanel-e5_nqNP9.js} +1 -1
  84. package/dist/cdn/{SvGridChartView-00LPUHL1.js → SvGridChartView-SmPW10dI.js} +1 -1
  85. package/dist/cdn/{SvGridChartView-BhUEJ5ki.js → SvGridChartView-eSPuJE6g.js} +1 -1
  86. package/dist/cdn/{SvGridDropdown-D0VdjeR8.js → SvGridDropdown-B1ZcLpgs.js} +1 -1
  87. package/dist/cdn/{SvGridDropdown-D13MtJ2j.js → SvGridDropdown-CtdbHcIS.js} +1 -1
  88. package/dist/cdn/date-format-CcP1tafP.js +1395 -0
  89. package/dist/cdn/date-format-DZT7T1wf.js +1393 -0
  90. package/dist/cdn/{editor-registry-CiI0xlKg.js → editor-registry-BhgE3S84.js} +51 -25
  91. package/dist/cdn/{src-C9Hihx1W.js → src-COC0vnpg.js} +7233 -6701
  92. package/dist/cdn/{src-D1lXwq1l.js → src-pYGV2rMR.js} +5747 -5215
  93. package/dist/cdn/svgrid.js +15 -13
  94. package/dist/cdn/svgrid.svelte-external.js +15 -13
  95. package/dist/cell-values.d.ts +16 -0
  96. package/dist/cell-values.js +28 -0
  97. package/dist/chart-export.js +8 -8
  98. package/dist/clipboard.d.ts +22 -0
  99. package/dist/clipboard.js +405 -27
  100. package/dist/editing.js +12 -7
  101. package/dist/editors/cell-editors.d.ts +11 -0
  102. package/dist/editors/cell-editors.js +18 -1
  103. package/dist/grid-messages.d.ts +15 -0
  104. package/dist/grid-messages.js +15 -0
  105. package/dist/index.d.ts +4 -0
  106. package/dist/index.js +4 -0
  107. package/dist/list-option.d.ts +6 -0
  108. package/dist/menus.js +40 -7
  109. package/dist/sanitize-html.d.ts +37 -0
  110. package/dist/sanitize-html.js +234 -0
  111. package/dist/selection-bar-view.svelte.d.ts +25 -0
  112. package/dist/selection-bar-view.svelte.js +13 -0
  113. package/dist/selection.d.ts +2 -1
  114. package/dist/selection.js +129 -13
  115. package/package.json +11 -11
  116. package/src/FlexRender.svelte +96 -96
  117. package/src/GridFooter.svelte +181 -181
  118. package/src/GridMenus.svelte +184 -6
  119. package/src/SvAutoComplete.svelte +169 -165
  120. package/src/SvAvatar.svelte +75 -75
  121. package/src/SvCalendar.svelte +503 -503
  122. package/src/SvCalendar.test.ts +226 -226
  123. package/src/SvCarousel.svelte +141 -141
  124. package/src/SvCheckBox.svelte +102 -102
  125. package/src/SvCircularProgress.svelte +109 -109
  126. package/src/SvColorInput.svelte +181 -181
  127. package/src/SvComboBox.svelte +279 -275
  128. package/src/SvContextMenu.svelte +116 -116
  129. package/src/SvCountryInput.svelte +163 -163
  130. package/src/SvDateRangeInput.svelte +25 -3
  131. package/src/SvDrawer.svelte +254 -254
  132. package/src/SvDropDownList.svelte +378 -374
  133. package/src/SvDurationInput.svelte +126 -126
  134. package/src/SvField.svelte +293 -293
  135. package/src/SvForm.svelte +437 -437
  136. package/src/SvForm.test.ts +411 -411
  137. package/src/SvGrid.controller.svelte.ts +251 -61
  138. package/src/SvGrid.css +221 -0
  139. package/src/SvGrid.helpers.ts +87 -0
  140. package/src/SvGrid.svelte +145 -0
  141. package/src/SvGrid.types.ts +2092 -1980
  142. package/src/SvGridCellEditor.svelte +744 -662
  143. package/src/SvGridChart.svelte +1716 -1716
  144. package/src/SvGridChartPanel.svelte +485 -485
  145. package/src/SvGridChartView.svelte +70 -70
  146. package/src/SvGridDropdown.svelte +728 -728
  147. package/src/SvGridSelect.svelte +270 -266
  148. package/src/SvGroupCell.svelte +116 -116
  149. package/src/SvListBox.svelte +334 -326
  150. package/src/SvMaskedInput.svelte +122 -122
  151. package/src/SvMenu.svelte +124 -124
  152. package/src/SvMenu.test.ts +97 -97
  153. package/src/SvMenuList.svelte +146 -146
  154. package/src/SvMultiSelect.svelte +293 -289
  155. package/src/SvNumberInput.svelte +172 -168
  156. package/src/SvOtpInput.svelte +158 -158
  157. package/src/SvPasswordInput.svelte +151 -151
  158. package/src/SvPhoneInput.svelte +133 -133
  159. package/src/SvPopover.svelte +197 -197
  160. package/src/SvProgress.svelte +116 -116
  161. package/src/SvRadioGroup.svelte +107 -107
  162. package/src/SvRating.svelte +112 -112
  163. package/src/SvResult.svelte +73 -73
  164. package/src/SvRichCell.svelte +125 -0
  165. package/src/SvRichText.svelte +211 -211
  166. package/src/SvRowGroupPanel.svelte +170 -170
  167. package/src/SvScrollArea.svelte +61 -61
  168. package/src/SvSlider.svelte +203 -203
  169. package/src/SvSwitchButton.svelte +108 -108
  170. package/src/SvTagsInput.svelte +115 -115
  171. package/src/SvTextArea.svelte +5 -1
  172. package/src/SvTextInput.svelte +147 -147
  173. package/src/SvTimePicker.svelte +245 -245
  174. package/src/SvToaster.svelte +159 -159
  175. package/src/SvToaster.test.ts +95 -95
  176. package/src/SvToggleButton.svelte +85 -85
  177. package/src/SvTooltip.svelte +161 -161
  178. package/src/SvTour.svelte +208 -208
  179. package/src/SvTree.svelte +444 -444
  180. package/src/SvTreeSelect.svelte +239 -235
  181. package/src/a11y/dismissable.test.ts +119 -119
  182. package/src/a11y/dismissable.ts +114 -114
  183. package/src/a11y.contract.test.ts +49 -49
  184. package/src/a11y.test.ts +59 -59
  185. package/src/a11y.ts +61 -61
  186. package/src/ai.test.ts +502 -502
  187. package/src/ai.ts +1419 -1419
  188. package/src/build-api.coverage.test.ts +633 -633
  189. package/src/build-api.ts +846 -846
  190. package/src/builtin-editors.grid.test.ts +83 -83
  191. package/src/builtin-editors.test.ts +18 -1
  192. package/src/builtin-editors.ts +19 -3
  193. package/src/cell-formatting.ts +171 -171
  194. package/src/cell-render.test.ts +513 -513
  195. package/src/cell-render.ts +496 -496
  196. package/src/cell-values.ts +148 -118
  197. package/src/chart-export.ts +202 -202
  198. package/src/chart-view.svelte.ts +36 -36
  199. package/src/chart.ts +2321 -2321
  200. package/src/clipboard.test.ts +93 -20
  201. package/src/clipboard.ts +433 -33
  202. package/src/collaboration.test.ts +104 -104
  203. package/src/collaboration.ts +167 -167
  204. package/src/column-groups.ts +78 -78
  205. package/src/core.performance.test.ts +30 -30
  206. package/src/core.ts +1865 -1865
  207. package/src/createAutocomplete.svelte.ts +132 -132
  208. package/src/createCombobox.svelte.ts +191 -191
  209. package/src/createCountryInput.svelte.ts +157 -157
  210. package/src/createDropdownList.svelte.ts +168 -168
  211. package/src/createForm.svelte.ts +386 -386
  212. package/src/createGrid.svelte.ts +42 -42
  213. package/src/createGrid.test.ts +10 -10
  214. package/src/createGridState.svelte.ts +17 -17
  215. package/src/createListbox.svelte.ts +250 -250
  216. package/src/createMenu.svelte.ts +224 -224
  217. package/src/createPopoverSelect.svelte.ts +213 -213
  218. package/src/createSlider.svelte.ts +191 -191
  219. package/src/createTooltip.svelte.ts +144 -144
  220. package/src/createTree.svelte.ts +322 -322
  221. package/src/date-string-column.test.ts +87 -0
  222. package/src/datetime/date-core.ts +206 -206
  223. package/src/datetime/date-restrict.ts +61 -61
  224. package/src/datetime/timezone.ts +135 -135
  225. package/src/dock-manager-model.ts +596 -596
  226. package/src/dock-model.ts +374 -374
  227. package/src/editing.test.ts +974 -949
  228. package/src/editing.ts +609 -606
  229. package/src/editor-block-prop.test.ts +132 -0
  230. package/src/editor-contract.ts +171 -171
  231. package/src/editor-registry.grid.test.ts +144 -144
  232. package/src/editor-registry.ts +122 -122
  233. package/src/editors/cell-editors.ts +27 -1
  234. package/src/export-data-api.test.ts +126 -126
  235. package/src/export-format.test.ts +107 -107
  236. package/src/export-format.ts +601 -601
  237. package/src/filter-operators.ts +160 -160
  238. package/src/filtering/excel-filters.ts +325 -325
  239. package/src/flex-render.ts +3 -3
  240. package/src/form-field.ts +127 -127
  241. package/src/grid-messages.ts +34 -0
  242. package/src/group-display.test.ts +167 -167
  243. package/src/group-display.ts +200 -200
  244. package/src/headless.ts +87 -87
  245. package/src/index.ts +13 -0
  246. package/src/js-scroller.svelte.ts +173 -173
  247. package/src/keyboard-handlers.ts +270 -270
  248. package/src/keyboard.test.ts +59 -59
  249. package/src/keyboard.ts +97 -97
  250. package/src/list-nav.test.ts +49 -49
  251. package/src/list-nav.ts +29 -29
  252. package/src/list-option.test.ts +56 -56
  253. package/src/list-option.ts +179 -173
  254. package/src/menus.test.ts +43 -0
  255. package/src/menus.ts +597 -567
  256. package/src/merge-objects.ts +48 -48
  257. package/src/move-cells.test.ts +850 -0
  258. package/src/number-editor-literal.test.ts +84 -0
  259. package/src/number-editor.grid.test.ts +160 -0
  260. package/src/overlays.test.ts +90 -90
  261. package/src/positioning.ts +268 -268
  262. package/src/render-component.ts +28 -28
  263. package/src/row-drag-touch.ts +211 -211
  264. package/src/row-drag.test.ts +353 -353
  265. package/src/row-drag.ts +415 -415
  266. package/src/row-resize.test.ts +524 -524
  267. package/src/row-resize.ts +228 -228
  268. package/src/sanitize-html.test.ts +182 -0
  269. package/src/sanitize-html.ts +235 -0
  270. package/src/scheduler-ical.ts +181 -181
  271. package/src/scheduler-model.test.ts +562 -562
  272. package/src/scheduler-model.ts +873 -873
  273. package/src/selection-bar-view.svelte.ts +36 -0
  274. package/src/selection.test.ts +900 -743
  275. package/src/selection.ts +131 -13
  276. package/src/server-data-source.test.ts +383 -383
  277. package/src/server-data-source.ts +469 -469
  278. package/src/sparkline.test.ts +68 -68
  279. package/src/sparkline.ts +169 -169
  280. package/src/spreadsheet.test.ts +488 -488
  281. package/src/spreadsheet.ts +312 -312
  282. package/src/static-functions.ts +11 -11
  283. package/src/subscribe.ts +38 -38
  284. package/src/summaries.ts +113 -113
  285. package/src/svgrid-wrapper.types.ts +563 -563
  286. package/src/svgrid.async-editor-options.test.ts +273 -273
  287. package/src/svgrid.auto-row-height.test.ts +204 -204
  288. package/src/svgrid.behavior.test.ts +910 -910
  289. package/src/svgrid.charting.test.ts +534 -534
  290. package/src/svgrid.comments-autocomplete.test.ts +127 -127
  291. package/src/svgrid.context-menu.test.ts +147 -147
  292. package/src/svgrid.features.test.ts +157 -157
  293. package/src/svgrid.filter-depth.test.ts +163 -163
  294. package/src/svgrid.filter-menu-listbox.svelte.test.ts +377 -331
  295. package/src/svgrid.filter-menu-scroll.test.ts +112 -112
  296. package/src/svgrid.grand-total.test.ts +188 -188
  297. package/src/svgrid.group-display-mode.test.ts +171 -171
  298. package/src/svgrid.group-footers.test.ts +121 -121
  299. package/src/svgrid.group-pagination.test.ts +153 -153
  300. package/src/svgrid.in-suggest-snapshot.svelte.test.ts +91 -0
  301. package/src/svgrid.menu-scroll-close.test.ts +204 -0
  302. package/src/svgrid.new-features.wrapper.test.ts +251 -251
  303. package/src/svgrid.selection-bar-seam.test.ts +185 -0
  304. package/src/svgrid.tree-data.test.ts +186 -186
  305. package/src/svgrid.upsell-license.test.ts +117 -0
  306. package/src/svgrid.wrapper.test.ts +63 -63
  307. package/src/svgriddropdown.async-panel.svelte.test.ts +195 -195
  308. package/src/test-setup.ts +62 -62
  309. package/src/themes/index.ts +288 -288
  310. package/src/toast-store.svelte.ts +250 -250
  311. package/src/toast-store.test.ts +147 -147
  312. package/src/tree-row-model.test.ts +168 -168
  313. package/src/ui-buttons.test.ts +144 -144
  314. package/src/ui-inputs.test.ts +118 -118
  315. package/src/ui-localization.test.ts +113 -113
  316. package/src/ui-range.test.ts +70 -70
  317. package/src/ui-selection.test.ts +155 -155
  318. package/src/ui-tier1.test.ts +142 -142
  319. package/src/virtual.test.ts +88 -88
  320. package/src/virtualization/column-virtualizer.test.ts +27 -27
  321. package/src/virtualization/column-virtualizer.ts +30 -30
  322. package/src/virtualization/svelte-virtualizer.svelte.ts +26 -26
  323. package/src/virtualization/types.ts +30 -30
  324. package/src/virtualization/virtualizer.test.ts +47 -47
  325. package/src/virtualization/virtualizer.ts +322 -322
  326. package/dist/cdn/GridMenus-BuoBPqxx.js +0 -493
  327. package/dist/cdn/GridMenus-n4llxoOI.js +0 -494
  328. package/dist/cdn/SvDateTimePicker-CHnUkWcH.js +0 -2206
  329. package/dist/cdn/SvDateTimePicker-CRQH_U7E.js +0 -2201
  330. package/dist/cdn/SvGridCellEditor-BGUCzuPB.js +0 -523
  331. package/dist/cdn/SvGridCellEditor-G8IMWIws.js +0 -522
@@ -1,325 +1,325 @@
1
- export type ExcelFilterOperator =
2
- | 'contains'
3
- | 'notContains'
4
- | 'equals'
5
- | 'notEquals'
6
- | 'startsWith'
7
- | 'endsWith'
8
- | 'regex'
9
- | 'in'
10
- | 'notIn'
11
- | 'greaterThan'
12
- | 'lessThan'
13
- | 'between'
14
- | 'isBlank'
15
- | 'isNotBlank'
16
-
17
- export type ExcelFilter = {
18
- id: string
19
- operator: ExcelFilterOperator
20
- value?: unknown
21
- valueTo?: unknown
22
- }
23
-
24
- export type ExcelFilterOptions = {
25
- /**
26
- * BCP-47 locale tag (or fallback list) for accent- and case-
27
- * insensitive text comparison. When set, "café", "Café" and "CAFÉ"
28
- * all match "cafe" without strain.
29
- *
30
- * Implementation: NFD-decompose both sides, strip combining marks
31
- * (diacritics), then locale-aware lowercase. This is the standard
32
- * "lowercase + asciifolding" pipeline used by Elasticsearch, Postgres
33
- * (with `unaccent`), and Lucene. Cheap, deterministic, no Collator
34
- * round-trip.
35
- */
36
- locale?: string | ReadonlyArray<string>
37
- }
38
-
39
- // U+0300..U+036F is the Combining Diacritical Marks block. After NFD
40
- // decomposition accented characters become "base char + combining mark";
41
- // stripping the marks leaves the bare ASCII base.
42
- const DIACRITIC_RE = /[̀-ͯ]/g
43
-
44
- /** NFD-decompose, strip combining marks (diacritics), then locale-aware
45
- * lowercase. The locale-aware lowercasing handles Turkish dotted-I /
46
- * dotless-i correctly when the consumer threads `"tr"` through. */
47
- export function normalizeForFilter(
48
- s: string,
49
- locale?: string | ReadonlyArray<string>,
50
- ): string {
51
- if (!s) return ''
52
-
53
- // Fast path for pure-ASCII input, which is the overwhelming majority of what
54
- // a grid filters. Both of the expensive steps are provably no-ops there:
55
- // ASCII is already NFD-normalised, and the combining-marks block this strips
56
- // (U+0300..U+036F) contains no ASCII. So lowercasing alone is the same
57
- // answer, and `normalize-fast-path.test.ts` checks that exhaustively over
58
- // every ASCII code point rather than taking the argument on trust.
59
- //
60
- // Worth the branch: this runs once per cell per filter - 100,000 times for a
61
- // one-column filter over a 100k grid - and a CPU profile of a browser filter
62
- // put more time in this function than in any other.
63
- //
64
- // Note the locale still routes through toLocaleLowerCase even on the fast
65
- // path: 'I'.toLocaleLowerCase('tr') is 'ı', so ASCII does NOT imply the
66
- // locale can be ignored.
67
- if (isAsciiOnly(s)) {
68
- return locale ? s.toLocaleLowerCase(locale as string | string[]) : s.toLowerCase()
69
- }
70
-
71
- const stripped = s.normalize('NFD').replace(DIACRITIC_RE, '')
72
- return locale
73
- ? stripped.toLocaleLowerCase(locale as string | string[])
74
- : stripped.toLowerCase()
75
- }
76
-
77
- /**
78
- * True when every code unit is ASCII. A plain char-code scan, which is far
79
- * cheaper than the `normalize()` + regex pass it lets us skip.
80
- */
81
- function isAsciiOnly(s: string): boolean {
82
- for (let i = 0; i < s.length; i++) {
83
- if (s.charCodeAt(i) > 127) return false
84
- }
85
- return true
86
- }
87
-
88
- /**
89
- * Delimiter used to serialise the `in` / `notIn` value list into the single
90
- * `value` string that the filter model carries.
91
- *
92
- * This has to be single-line safe: the tool panel and the filter menu show the
93
- * serialised list in a plain `<input type="text">`, and the HTML input value
94
- * sanitiser STRIPS newlines - so a newline-joined list came back out of the DOM
95
- * as one run-together token. `splitInTokens` accepts newlines too, so values
96
- * serialised by older builds still parse.
97
- */
98
- export const IN_TOKEN_SEP = ', '
99
-
100
- /**
101
- * Split a serialised `in` / `notIn` value into its individual tokens.
102
- *
103
- * The grammar is CSV-shaped: comma OR newline separates, and a token may be
104
- * double-quoted to carry a separator literally (`""` escapes a quote inside
105
- * one). Quoting is what makes a comma separator safe - facet values commonly
106
- * contain commas of their own, because numeric bucket labels are built with
107
- * `toLocaleString` ("1,234 - 5,678") and date labels with a short month
108
- * ("Aug 17, 2026"). A quote only opens a token when it is the token's first
109
- * non-space character, so an unquoted `5" pipe` stays literal.
110
- */
111
- export function splitInTokens(value: unknown): string[] {
112
- const { tokens, trailing } = scanInTokens(value)
113
- if (trailing) tokens.push(trailing)
114
- return tokens
115
- }
116
-
117
- /**
118
- * Serialise a list of tokens back into the single `in` / `notIn` value,
119
- * quoting any token that carries a separator or a quote of its own.
120
- */
121
- export function joinInTokens(tokens: ReadonlyArray<string>): string {
122
- return tokens
123
- .map((t) => t.trim())
124
- .filter((t) => t.length > 0)
125
- .map((t) => (/["\n,]/.test(t) ? `"${t.replace(/"/g, '""')}"` : t))
126
- .join(IN_TOKEN_SEP)
127
- }
128
-
129
- /**
130
- * The token still being typed at the end of an `in` / `notIn` value - the text
131
- * after the last separator. `'AAPL, MS'` -> `'MS'`; a value ending in a
132
- * separator (or empty) has no trailing token.
133
- *
134
- * Inputs that hold the whole token list use this to drive the value-suggestion
135
- * dropdown: the trailing fragment is the search query, not a committed token.
136
- */
137
- export function trailingInToken(value: unknown): string {
138
- return scanInTokens(value).trailing
139
- }
140
-
141
- /**
142
- * One pass over a serialised `in` / `notIn` value, splitting it into the
143
- * tokens that are terminated by a separator and the unterminated fragment at
144
- * the end. Every token helper above is a view onto this, so they can never
145
- * disagree about where a quoted token starts or ends.
146
- */
147
- function scanInTokens(value: unknown): { tokens: string[]; trailing: string } {
148
- const raw = String(value ?? '')
149
- const tokens: string[] = []
150
- let buf = ''
151
- let quoted = false
152
- let wasQuoted = false
153
- let closed = false
154
-
155
- // A quoted token keeps its inner spacing; an unquoted one is trimmed.
156
- const take = () => {
157
- const t = wasQuoted ? buf : buf.trim()
158
- buf = ''
159
- wasQuoted = false
160
- closed = false
161
- return t
162
- }
163
-
164
- for (let i = 0; i < raw.length; i += 1) {
165
- const ch = raw[i]
166
- if (quoted) {
167
- if (ch !== '"') { buf += ch; continue }
168
- // A doubled quote is an escaped literal quote, not the closing one.
169
- if (raw[i + 1] === '"') { buf += '"'; i += 1; continue }
170
- quoted = false
171
- closed = true
172
- continue
173
- }
174
- if (ch === ',' || ch === '\n') {
175
- const t = take()
176
- if (t.length) tokens.push(t)
177
- continue
178
- }
179
- // Only opens a quoted token at the token's start - `5" pipe` is literal.
180
- if (ch === '"' && !closed && !buf.trim()) {
181
- quoted = true
182
- wasQuoted = true
183
- buf = ''
184
- continue
185
- }
186
- buf += ch
187
- }
188
-
189
- return { tokens, trailing: take() }
190
- }
191
-
192
- // Re-exported here so consumers can reach the catalogue through the
193
- // `@svgrid/grid/filtering` subpath. Importing it from the package root would
194
- // pull in SvGrid.svelte, which is a runtime cost (and a bundler hazard) for
195
- // anything that only wants operator semantics.
196
- export {
197
- ALL_FILTER_OPERATORS,
198
- SET_OPERATOR_IDS,
199
- VALUELESS_OPERATOR_IDS,
200
- RANGE_OPERATOR_IDS,
201
- isSetOperator,
202
- isValuelessOperator,
203
- isRangeOperator,
204
- type FilterValueType,
205
- } from './filter-operator-catalogue.js'
206
-
207
- /** A filter with its needle-side work already done. Call per row. */
208
- export type CompiledExcelFilter = (cellValue: unknown) => boolean
209
-
210
- /**
211
- * Compile a filter once, then test many rows against it.
212
- *
213
- * Everything that depends only on the FILTER - folding the needle, splitting
214
- * `in` tokens, building the regex, coercing range endpoints - happens here,
215
- * so the per-row closure does the minimum. Filtering 100k rows used to redo
216
- * all of it 100k times.
217
- *
218
- * `applyExcelFilter` is defined in terms of this, so there is exactly one
219
- * copy of the operator semantics.
220
- */
221
- export function compileExcelFilter(
222
- filter: ExcelFilter,
223
- options?: ExcelFilterOptions,
224
- ): CompiledExcelFilter {
225
- const locale = options?.locale
226
- const fold = (v: unknown) => normalizeForFilter(String(v ?? ''), locale)
227
- const needle = fold(filter.value)
228
-
229
- switch (filter.operator) {
230
- case 'contains':
231
- return (cellValue) => fold(cellValue).includes(needle)
232
- case 'notContains':
233
- // An empty needle is no constraint (mirrors `contains` returning true),
234
- // so nothing is excluded until the user types something.
235
- if (needle === '') return () => true
236
- return (cellValue) => !fold(cellValue).includes(needle)
237
- case 'equals':
238
- return (cellValue) => fold(cellValue) === needle
239
- case 'notEquals':
240
- if (needle === '') return () => true
241
- return (cellValue) => fold(cellValue) !== needle
242
- case 'startsWith':
243
- return (cellValue) => fold(cellValue).startsWith(needle)
244
- case 'endsWith':
245
- return (cellValue) => fold(cellValue).endsWith(needle)
246
- case 'regex': {
247
- // Case-insensitive by default (matches the accent/case-folded feel of
248
- // the other text operators). An invalid pattern matches nothing rather
249
- // than throwing, so a half-typed regex never crashes the row model.
250
- // Note this tests the RAW text, not the folded text.
251
- const pattern = String(filter.value ?? '')
252
- if (!pattern) return () => true
253
- let re: RegExp
254
- try {
255
- re = new RegExp(pattern, 'i')
256
- } catch {
257
- return () => false
258
- }
259
- return (cellValue) => re.test(String(cellValue ?? ''))
260
- }
261
- case 'in':
262
- case 'notIn': {
263
- const tokens = splitInTokens(filter.value)
264
- if (tokens.length === 0) return () => true
265
- // A Set of pre-folded tokens turns the old per-row `tokens.some(...)`
266
- // (which re-folded every token for every row) into one lookup.
267
- const wanted = new Set(tokens.map((t) => normalizeForFilter(t, locale)))
268
- if (filter.operator === 'in') return (cellValue) => wanted.has(fold(cellValue))
269
- return (cellValue) => !wanted.has(fold(cellValue))
270
- }
271
- case 'greaterThan': {
272
- const b = Number(filter.value)
273
- const bFinite = Number.isFinite(b)
274
- const bText = String(filter.value ?? '')
275
- return (cellValue) => {
276
- const a = Number(cellValue)
277
- if (bFinite && Number.isFinite(a)) return a > b
278
- return String(cellValue ?? '') > bText
279
- }
280
- }
281
- case 'lessThan': {
282
- const b = Number(filter.value)
283
- const bFinite = Number.isFinite(b)
284
- const bText = String(filter.value ?? '')
285
- return (cellValue) => {
286
- const a = Number(cellValue)
287
- if (bFinite && Number.isFinite(a)) return a < b
288
- return String(cellValue ?? '') < bText
289
- }
290
- }
291
- case 'between': {
292
- // Two paths: numeric (coerce both endpoints with the historical
293
- // `?? 0` fallback) and string (used when EITHER endpoint is a
294
- // non-numeric string like an ISO date). Numeric wins when its
295
- // operands are finite so callers passing numeric ages, prices, etc.
296
- // see the historical inclusive-range behaviour.
297
- const lo = filter.value == null ? 0 : Number(filter.value)
298
- const hi = filter.valueTo == null ? 0 : Number(filter.valueTo)
299
- const rangeFinite = Number.isFinite(lo) && Number.isFinite(hi)
300
- // Either endpoint is non-numeric (ISO date string, etc). Compare
301
- // lexicographically - YYYY-MM-DD orders chronologically so the
302
- // result matches user intent.
303
- const sl = String(filter.value ?? '')
304
- const sh = String(filter.valueTo ?? '')
305
- return (cellValue) => {
306
- const a = Number(cellValue ?? 0)
307
- if (rangeFinite && Number.isFinite(a)) return a >= lo && a <= hi
308
- const s = String(cellValue ?? '')
309
- return s >= sl && s <= sh
310
- }
311
- }
312
- case 'isBlank':
313
- return (cellValue) => String(cellValue ?? '').trim().length === 0
314
- case 'isNotBlank':
315
- return (cellValue) => String(cellValue ?? '').trim().length > 0
316
- }
317
- }
318
-
319
- export function applyExcelFilter(
320
- cellValue: unknown,
321
- filter: ExcelFilter,
322
- options?: ExcelFilterOptions,
323
- ) {
324
- return compileExcelFilter(filter, options)(cellValue)
325
- }
1
+ export type ExcelFilterOperator =
2
+ | 'contains'
3
+ | 'notContains'
4
+ | 'equals'
5
+ | 'notEquals'
6
+ | 'startsWith'
7
+ | 'endsWith'
8
+ | 'regex'
9
+ | 'in'
10
+ | 'notIn'
11
+ | 'greaterThan'
12
+ | 'lessThan'
13
+ | 'between'
14
+ | 'isBlank'
15
+ | 'isNotBlank'
16
+
17
+ export type ExcelFilter = {
18
+ id: string
19
+ operator: ExcelFilterOperator
20
+ value?: unknown
21
+ valueTo?: unknown
22
+ }
23
+
24
+ export type ExcelFilterOptions = {
25
+ /**
26
+ * BCP-47 locale tag (or fallback list) for accent- and case-
27
+ * insensitive text comparison. When set, "café", "Café" and "CAFÉ"
28
+ * all match "cafe" without strain.
29
+ *
30
+ * Implementation: NFD-decompose both sides, strip combining marks
31
+ * (diacritics), then locale-aware lowercase. This is the standard
32
+ * "lowercase + asciifolding" pipeline used by Elasticsearch, Postgres
33
+ * (with `unaccent`), and Lucene. Cheap, deterministic, no Collator
34
+ * round-trip.
35
+ */
36
+ locale?: string | ReadonlyArray<string>
37
+ }
38
+
39
+ // U+0300..U+036F is the Combining Diacritical Marks block. After NFD
40
+ // decomposition accented characters become "base char + combining mark";
41
+ // stripping the marks leaves the bare ASCII base.
42
+ const DIACRITIC_RE = /[̀-ͯ]/g
43
+
44
+ /** NFD-decompose, strip combining marks (diacritics), then locale-aware
45
+ * lowercase. The locale-aware lowercasing handles Turkish dotted-I /
46
+ * dotless-i correctly when the consumer threads `"tr"` through. */
47
+ export function normalizeForFilter(
48
+ s: string,
49
+ locale?: string | ReadonlyArray<string>,
50
+ ): string {
51
+ if (!s) return ''
52
+
53
+ // Fast path for pure-ASCII input, which is the overwhelming majority of what
54
+ // a grid filters. Both of the expensive steps are provably no-ops there:
55
+ // ASCII is already NFD-normalised, and the combining-marks block this strips
56
+ // (U+0300..U+036F) contains no ASCII. So lowercasing alone is the same
57
+ // answer, and `normalize-fast-path.test.ts` checks that exhaustively over
58
+ // every ASCII code point rather than taking the argument on trust.
59
+ //
60
+ // Worth the branch: this runs once per cell per filter - 100,000 times for a
61
+ // one-column filter over a 100k grid - and a CPU profile of a browser filter
62
+ // put more time in this function than in any other.
63
+ //
64
+ // Note the locale still routes through toLocaleLowerCase even on the fast
65
+ // path: 'I'.toLocaleLowerCase('tr') is 'ı', so ASCII does NOT imply the
66
+ // locale can be ignored.
67
+ if (isAsciiOnly(s)) {
68
+ return locale ? s.toLocaleLowerCase(locale as string | string[]) : s.toLowerCase()
69
+ }
70
+
71
+ const stripped = s.normalize('NFD').replace(DIACRITIC_RE, '')
72
+ return locale
73
+ ? stripped.toLocaleLowerCase(locale as string | string[])
74
+ : stripped.toLowerCase()
75
+ }
76
+
77
+ /**
78
+ * True when every code unit is ASCII. A plain char-code scan, which is far
79
+ * cheaper than the `normalize()` + regex pass it lets us skip.
80
+ */
81
+ function isAsciiOnly(s: string): boolean {
82
+ for (let i = 0; i < s.length; i++) {
83
+ if (s.charCodeAt(i) > 127) return false
84
+ }
85
+ return true
86
+ }
87
+
88
+ /**
89
+ * Delimiter used to serialise the `in` / `notIn` value list into the single
90
+ * `value` string that the filter model carries.
91
+ *
92
+ * This has to be single-line safe: the tool panel and the filter menu show the
93
+ * serialised list in a plain `<input type="text">`, and the HTML input value
94
+ * sanitiser STRIPS newlines - so a newline-joined list came back out of the DOM
95
+ * as one run-together token. `splitInTokens` accepts newlines too, so values
96
+ * serialised by older builds still parse.
97
+ */
98
+ export const IN_TOKEN_SEP = ', '
99
+
100
+ /**
101
+ * Split a serialised `in` / `notIn` value into its individual tokens.
102
+ *
103
+ * The grammar is CSV-shaped: comma OR newline separates, and a token may be
104
+ * double-quoted to carry a separator literally (`""` escapes a quote inside
105
+ * one). Quoting is what makes a comma separator safe - facet values commonly
106
+ * contain commas of their own, because numeric bucket labels are built with
107
+ * `toLocaleString` ("1,234 - 5,678") and date labels with a short month
108
+ * ("Aug 17, 2026"). A quote only opens a token when it is the token's first
109
+ * non-space character, so an unquoted `5" pipe` stays literal.
110
+ */
111
+ export function splitInTokens(value: unknown): string[] {
112
+ const { tokens, trailing } = scanInTokens(value)
113
+ if (trailing) tokens.push(trailing)
114
+ return tokens
115
+ }
116
+
117
+ /**
118
+ * Serialise a list of tokens back into the single `in` / `notIn` value,
119
+ * quoting any token that carries a separator or a quote of its own.
120
+ */
121
+ export function joinInTokens(tokens: ReadonlyArray<string>): string {
122
+ return tokens
123
+ .map((t) => t.trim())
124
+ .filter((t) => t.length > 0)
125
+ .map((t) => (/["\n,]/.test(t) ? `"${t.replace(/"/g, '""')}"` : t))
126
+ .join(IN_TOKEN_SEP)
127
+ }
128
+
129
+ /**
130
+ * The token still being typed at the end of an `in` / `notIn` value - the text
131
+ * after the last separator. `'AAPL, MS'` -> `'MS'`; a value ending in a
132
+ * separator (or empty) has no trailing token.
133
+ *
134
+ * Inputs that hold the whole token list use this to drive the value-suggestion
135
+ * dropdown: the trailing fragment is the search query, not a committed token.
136
+ */
137
+ export function trailingInToken(value: unknown): string {
138
+ return scanInTokens(value).trailing
139
+ }
140
+
141
+ /**
142
+ * One pass over a serialised `in` / `notIn` value, splitting it into the
143
+ * tokens that are terminated by a separator and the unterminated fragment at
144
+ * the end. Every token helper above is a view onto this, so they can never
145
+ * disagree about where a quoted token starts or ends.
146
+ */
147
+ function scanInTokens(value: unknown): { tokens: string[]; trailing: string } {
148
+ const raw = String(value ?? '')
149
+ const tokens: string[] = []
150
+ let buf = ''
151
+ let quoted = false
152
+ let wasQuoted = false
153
+ let closed = false
154
+
155
+ // A quoted token keeps its inner spacing; an unquoted one is trimmed.
156
+ const take = () => {
157
+ const t = wasQuoted ? buf : buf.trim()
158
+ buf = ''
159
+ wasQuoted = false
160
+ closed = false
161
+ return t
162
+ }
163
+
164
+ for (let i = 0; i < raw.length; i += 1) {
165
+ const ch = raw[i]
166
+ if (quoted) {
167
+ if (ch !== '"') { buf += ch; continue }
168
+ // A doubled quote is an escaped literal quote, not the closing one.
169
+ if (raw[i + 1] === '"') { buf += '"'; i += 1; continue }
170
+ quoted = false
171
+ closed = true
172
+ continue
173
+ }
174
+ if (ch === ',' || ch === '\n') {
175
+ const t = take()
176
+ if (t.length) tokens.push(t)
177
+ continue
178
+ }
179
+ // Only opens a quoted token at the token's start - `5" pipe` is literal.
180
+ if (ch === '"' && !closed && !buf.trim()) {
181
+ quoted = true
182
+ wasQuoted = true
183
+ buf = ''
184
+ continue
185
+ }
186
+ buf += ch
187
+ }
188
+
189
+ return { tokens, trailing: take() }
190
+ }
191
+
192
+ // Re-exported here so consumers can reach the catalogue through the
193
+ // `@svgrid/grid/filtering` subpath. Importing it from the package root would
194
+ // pull in SvGrid.svelte, which is a runtime cost (and a bundler hazard) for
195
+ // anything that only wants operator semantics.
196
+ export {
197
+ ALL_FILTER_OPERATORS,
198
+ SET_OPERATOR_IDS,
199
+ VALUELESS_OPERATOR_IDS,
200
+ RANGE_OPERATOR_IDS,
201
+ isSetOperator,
202
+ isValuelessOperator,
203
+ isRangeOperator,
204
+ type FilterValueType,
205
+ } from './filter-operator-catalogue.js'
206
+
207
+ /** A filter with its needle-side work already done. Call per row. */
208
+ export type CompiledExcelFilter = (cellValue: unknown) => boolean
209
+
210
+ /**
211
+ * Compile a filter once, then test many rows against it.
212
+ *
213
+ * Everything that depends only on the FILTER - folding the needle, splitting
214
+ * `in` tokens, building the regex, coercing range endpoints - happens here,
215
+ * so the per-row closure does the minimum. Filtering 100k rows used to redo
216
+ * all of it 100k times.
217
+ *
218
+ * `applyExcelFilter` is defined in terms of this, so there is exactly one
219
+ * copy of the operator semantics.
220
+ */
221
+ export function compileExcelFilter(
222
+ filter: ExcelFilter,
223
+ options?: ExcelFilterOptions,
224
+ ): CompiledExcelFilter {
225
+ const locale = options?.locale
226
+ const fold = (v: unknown) => normalizeForFilter(String(v ?? ''), locale)
227
+ const needle = fold(filter.value)
228
+
229
+ switch (filter.operator) {
230
+ case 'contains':
231
+ return (cellValue) => fold(cellValue).includes(needle)
232
+ case 'notContains':
233
+ // An empty needle is no constraint (mirrors `contains` returning true),
234
+ // so nothing is excluded until the user types something.
235
+ if (needle === '') return () => true
236
+ return (cellValue) => !fold(cellValue).includes(needle)
237
+ case 'equals':
238
+ return (cellValue) => fold(cellValue) === needle
239
+ case 'notEquals':
240
+ if (needle === '') return () => true
241
+ return (cellValue) => fold(cellValue) !== needle
242
+ case 'startsWith':
243
+ return (cellValue) => fold(cellValue).startsWith(needle)
244
+ case 'endsWith':
245
+ return (cellValue) => fold(cellValue).endsWith(needle)
246
+ case 'regex': {
247
+ // Case-insensitive by default (matches the accent/case-folded feel of
248
+ // the other text operators). An invalid pattern matches nothing rather
249
+ // than throwing, so a half-typed regex never crashes the row model.
250
+ // Note this tests the RAW text, not the folded text.
251
+ const pattern = String(filter.value ?? '')
252
+ if (!pattern) return () => true
253
+ let re: RegExp
254
+ try {
255
+ re = new RegExp(pattern, 'i')
256
+ } catch {
257
+ return () => false
258
+ }
259
+ return (cellValue) => re.test(String(cellValue ?? ''))
260
+ }
261
+ case 'in':
262
+ case 'notIn': {
263
+ const tokens = splitInTokens(filter.value)
264
+ if (tokens.length === 0) return () => true
265
+ // A Set of pre-folded tokens turns the old per-row `tokens.some(...)`
266
+ // (which re-folded every token for every row) into one lookup.
267
+ const wanted = new Set(tokens.map((t) => normalizeForFilter(t, locale)))
268
+ if (filter.operator === 'in') return (cellValue) => wanted.has(fold(cellValue))
269
+ return (cellValue) => !wanted.has(fold(cellValue))
270
+ }
271
+ case 'greaterThan': {
272
+ const b = Number(filter.value)
273
+ const bFinite = Number.isFinite(b)
274
+ const bText = String(filter.value ?? '')
275
+ return (cellValue) => {
276
+ const a = Number(cellValue)
277
+ if (bFinite && Number.isFinite(a)) return a > b
278
+ return String(cellValue ?? '') > bText
279
+ }
280
+ }
281
+ case 'lessThan': {
282
+ const b = Number(filter.value)
283
+ const bFinite = Number.isFinite(b)
284
+ const bText = String(filter.value ?? '')
285
+ return (cellValue) => {
286
+ const a = Number(cellValue)
287
+ if (bFinite && Number.isFinite(a)) return a < b
288
+ return String(cellValue ?? '') < bText
289
+ }
290
+ }
291
+ case 'between': {
292
+ // Two paths: numeric (coerce both endpoints with the historical
293
+ // `?? 0` fallback) and string (used when EITHER endpoint is a
294
+ // non-numeric string like an ISO date). Numeric wins when its
295
+ // operands are finite so callers passing numeric ages, prices, etc.
296
+ // see the historical inclusive-range behaviour.
297
+ const lo = filter.value == null ? 0 : Number(filter.value)
298
+ const hi = filter.valueTo == null ? 0 : Number(filter.valueTo)
299
+ const rangeFinite = Number.isFinite(lo) && Number.isFinite(hi)
300
+ // Either endpoint is non-numeric (ISO date string, etc). Compare
301
+ // lexicographically - YYYY-MM-DD orders chronologically so the
302
+ // result matches user intent.
303
+ const sl = String(filter.value ?? '')
304
+ const sh = String(filter.valueTo ?? '')
305
+ return (cellValue) => {
306
+ const a = Number(cellValue ?? 0)
307
+ if (rangeFinite && Number.isFinite(a)) return a >= lo && a <= hi
308
+ const s = String(cellValue ?? '')
309
+ return s >= sl && s <= sh
310
+ }
311
+ }
312
+ case 'isBlank':
313
+ return (cellValue) => String(cellValue ?? '').trim().length === 0
314
+ case 'isNotBlank':
315
+ return (cellValue) => String(cellValue ?? '').trim().length > 0
316
+ }
317
+ }
318
+
319
+ export function applyExcelFilter(
320
+ cellValue: unknown,
321
+ filter: ExcelFilter,
322
+ options?: ExcelFilterOptions,
323
+ ) {
324
+ return compileExcelFilter(filter, options)(cellValue)
325
+ }
@@ -1,3 +1,3 @@
1
- /// <reference types="svelte" />
2
-
3
- export { default as FlexRender } from './FlexRender.svelte'
1
+ /// <reference types="svelte" />
2
+
3
+ export { default as FlexRender } from './FlexRender.svelte'