@svgrid/grid 3.0.0 → 3.0.2

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 (304) hide show
  1. package/CHANGELOG.md +116 -88
  2. package/README.md +199 -199
  3. package/dist/FlexRender.svelte +96 -96
  4. package/dist/GridFooter.svelte +190 -181
  5. package/dist/GridFooter.svelte.d.ts +8 -0
  6. package/dist/GridMenus.svelte +18 -10
  7. package/dist/GridMenus.svelte.d.ts +2 -1
  8. package/dist/SvAutoComplete.svelte +169 -169
  9. package/dist/SvAvatar.svelte +75 -75
  10. package/dist/SvCalendar.svelte +503 -503
  11. package/dist/SvCarousel.svelte +141 -141
  12. package/dist/SvCheckBox.svelte +102 -102
  13. package/dist/SvCircularProgress.svelte +109 -109
  14. package/dist/SvColorInput.svelte +181 -181
  15. package/dist/SvComboBox.svelte +279 -279
  16. package/dist/SvContextMenu.svelte +116 -116
  17. package/dist/SvCountryInput.svelte +163 -163
  18. package/dist/SvDrawer.svelte +254 -254
  19. package/dist/SvDropDownList.svelte +378 -378
  20. package/dist/SvDurationInput.svelte +126 -126
  21. package/dist/SvField.svelte +293 -293
  22. package/dist/SvForm.svelte +437 -437
  23. package/dist/SvGrid.controller.svelte.d.ts +17 -0
  24. package/dist/SvGrid.controller.svelte.js +128 -14
  25. package/dist/SvGrid.css +79 -10
  26. package/dist/SvGrid.svelte +191 -186
  27. package/dist/SvGrid.types.d.ts +42 -1
  28. package/dist/SvGridCellEditor.svelte +748 -744
  29. package/dist/SvGridChart.svelte +2246 -1716
  30. package/dist/SvGridChart.svelte.d.ts +63 -1
  31. package/dist/SvGridChartPanel.svelte +633 -485
  32. package/dist/SvGridChartView.svelte +79 -70
  33. package/dist/SvGridChartView.svelte.d.ts +7 -0
  34. package/dist/SvGridDropdown.svelte +728 -728
  35. package/dist/SvGridSelect.svelte +270 -270
  36. package/dist/SvGroupCell.svelte +141 -116
  37. package/dist/SvGroupCell.svelte.d.ts +8 -0
  38. package/dist/SvListBox.svelte +334 -334
  39. package/dist/SvMaskedInput.svelte +122 -122
  40. package/dist/SvMenu.svelte +124 -124
  41. package/dist/SvMenuList.svelte +146 -146
  42. package/dist/SvMultiSelect.svelte +293 -293
  43. package/dist/SvNumberInput.svelte +172 -172
  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/SvRichText.svelte +211 -211
  53. package/dist/SvRowGroupPanel.svelte +186 -170
  54. package/dist/SvRowGroupPanel.svelte.d.ts +8 -0
  55. package/dist/SvScrollArea.svelte +61 -61
  56. package/dist/SvSlider.svelte +203 -203
  57. package/dist/SvSwitchButton.svelte +108 -108
  58. package/dist/SvTagsInput.svelte +115 -115
  59. package/dist/SvTextInput.svelte +147 -147
  60. package/dist/SvTimePicker.svelte +245 -245
  61. package/dist/SvToaster.svelte +159 -159
  62. package/dist/SvToggleButton.svelte +85 -85
  63. package/dist/SvTooltip.svelte +161 -161
  64. package/dist/SvTour.svelte +208 -208
  65. package/dist/SvTree.svelte +444 -444
  66. package/dist/SvTreeSelect.svelte +239 -239
  67. package/dist/ai.d.ts +11 -2
  68. package/dist/ai.js +51 -7
  69. package/dist/cdn/GridMenus-DyFA-QxA.js +602 -0
  70. package/dist/cdn/GridMenus-M2XP9t0_.js +603 -0
  71. package/dist/cdn/{SvDateRangeInput-DflbiP7N.js → SvDateRangeInput-CaOuMs8O.js} +1 -1
  72. package/dist/cdn/{SvDateRangeInput-Bh0A0JkF.js → SvDateRangeInput-DMLKmGEc.js} +1 -1
  73. package/dist/cdn/{SvDateTimePicker-Bivn8dAP.js → SvDateTimePicker-CCbDZNZB.js} +1 -1
  74. package/dist/cdn/{SvDateTimePicker-BWwpfB_o.js → SvDateTimePicker-sonaH0oh.js} +1 -1
  75. package/dist/cdn/{SvGridCellEditor-Ba7rY3eu.js → SvGridCellEditor-BWnTi2N7.js} +2 -2
  76. package/dist/cdn/{SvGridCellEditor-AXL8cHGO.js → SvGridCellEditor-CjEJMJKc.js} +2 -2
  77. package/dist/cdn/SvGridChart-DAb9RbRs.js +1480 -0
  78. package/dist/cdn/SvGridChart-Yl-IXZFO.js +1481 -0
  79. package/dist/cdn/SvGridChartPanel-DayQpDsR.js +834 -0
  80. package/dist/cdn/SvGridChartPanel-aqf8n-vJ.js +810 -0
  81. package/dist/cdn/{SvGridChartView-eSPuJE6g.js → SvGridChartView-CxfakxR0.js} +5 -3
  82. package/dist/cdn/{SvGridChartView-SmPW10dI.js → SvGridChartView-Dm_YEx9L.js} +5 -3
  83. package/dist/cdn/{SvGridDropdown-B1ZcLpgs.js → SvGridDropdown-D0VdjeR8.js} +1 -1
  84. package/dist/cdn/{SvGridDropdown-CtdbHcIS.js → SvGridDropdown-D13MtJ2j.js} +1 -1
  85. package/dist/cdn/cell-formatting-C2Hf5gqd.js +86 -0
  86. package/dist/cdn/chart-CKJRCPOk.js +1652 -0
  87. package/dist/cdn/{date-format-DZT7T1wf.js → date-format-BNii4zeD.js} +2 -2
  88. package/dist/cdn/{date-format-CcP1tafP.js → date-format-BnnHlqGw.js} +2 -2
  89. package/dist/cdn/{export-format-Cv1Dll6k.js → export-format-CUDLy2yn.js} +84 -168
  90. package/dist/cdn/{src-B_YS5AOc.js → src-BJ2opd0j.js} +3642 -3450
  91. package/dist/cdn/{src-DYXXpuSk.js → src-DNbz94Ct.js} +8649 -8457
  92. package/dist/cdn/svgrid.js +16 -15
  93. package/dist/cdn/svgrid.svelte-external.js +16 -15
  94. package/dist/cell-formatting.d.ts +7 -0
  95. package/dist/cell-formatting.js +7 -1
  96. package/dist/chart-export.d.ts +23 -2
  97. package/dist/chart-export.js +88 -14
  98. package/dist/chart.d.ts +410 -18
  99. package/dist/chart.js +824 -24
  100. package/dist/editing.js +22 -13
  101. package/dist/grid-icons.d.ts +49 -0
  102. package/dist/grid-icons.js +86 -0
  103. package/dist/index.d.ts +3 -2
  104. package/dist/index.js +3 -2
  105. package/package.json +1 -1
  106. package/src/FlexRender.svelte +96 -96
  107. package/src/GridFooter.svelte +190 -181
  108. package/src/GridMenus.svelte +18 -10
  109. package/src/SvAutoComplete.svelte +169 -169
  110. package/src/SvAvatar.svelte +75 -75
  111. package/src/SvCalendar.svelte +503 -503
  112. package/src/SvCalendar.test.ts +226 -226
  113. package/src/SvCarousel.svelte +141 -141
  114. package/src/SvCheckBox.svelte +102 -102
  115. package/src/SvCircularProgress.svelte +109 -109
  116. package/src/SvColorInput.svelte +181 -181
  117. package/src/SvComboBox.svelte +279 -279
  118. package/src/SvContextMenu.svelte +116 -116
  119. package/src/SvCountryInput.svelte +163 -163
  120. package/src/SvDrawer.svelte +254 -254
  121. package/src/SvDropDownList.svelte +378 -378
  122. package/src/SvDurationInput.svelte +126 -126
  123. package/src/SvField.svelte +293 -293
  124. package/src/SvForm.svelte +437 -437
  125. package/src/SvForm.test.ts +411 -411
  126. package/src/SvGrid.controller.svelte.ts +146 -13
  127. package/src/SvGrid.css +79 -10
  128. package/src/SvGrid.svelte +191 -186
  129. package/src/SvGrid.types.ts +2133 -2092
  130. package/src/SvGridCellEditor.svelte +748 -744
  131. package/src/SvGridChart.svelte +2246 -1716
  132. package/src/SvGridChart.test.ts +243 -1
  133. package/src/SvGridChartPanel.svelte +633 -485
  134. package/src/SvGridChartView.svelte +79 -70
  135. package/src/SvGridDropdown.svelte +728 -728
  136. package/src/SvGridSelect.svelte +270 -270
  137. package/src/SvGroupCell.svelte +141 -116
  138. package/src/SvListBox.svelte +334 -334
  139. package/src/SvMaskedInput.svelte +122 -122
  140. package/src/SvMenu.svelte +124 -124
  141. package/src/SvMenu.test.ts +97 -97
  142. package/src/SvMenuList.svelte +146 -146
  143. package/src/SvMultiSelect.svelte +293 -293
  144. package/src/SvNumberInput.svelte +172 -172
  145. package/src/SvOtpInput.svelte +158 -158
  146. package/src/SvPasswordInput.svelte +151 -151
  147. package/src/SvPhoneInput.svelte +133 -133
  148. package/src/SvPopover.svelte +197 -197
  149. package/src/SvProgress.svelte +116 -116
  150. package/src/SvRadioGroup.svelte +107 -107
  151. package/src/SvRating.svelte +112 -112
  152. package/src/SvResult.svelte +73 -73
  153. package/src/SvRichText.svelte +211 -211
  154. package/src/SvRowGroupPanel.svelte +186 -170
  155. package/src/SvScrollArea.svelte +61 -61
  156. package/src/SvSlider.svelte +203 -203
  157. package/src/SvSwitchButton.svelte +108 -108
  158. package/src/SvTagsInput.svelte +115 -115
  159. package/src/SvTextInput.svelte +147 -147
  160. package/src/SvTimePicker.svelte +245 -245
  161. package/src/SvToaster.svelte +159 -159
  162. package/src/SvToaster.test.ts +95 -95
  163. package/src/SvToggleButton.svelte +85 -85
  164. package/src/SvTooltip.svelte +161 -161
  165. package/src/SvTour.svelte +208 -208
  166. package/src/SvTree.svelte +444 -444
  167. package/src/SvTreeSelect.svelte +239 -239
  168. package/src/a11y/dismissable.test.ts +119 -119
  169. package/src/a11y/dismissable.ts +114 -114
  170. package/src/a11y.contract.test.ts +49 -49
  171. package/src/a11y.test.ts +59 -59
  172. package/src/a11y.ts +61 -61
  173. package/src/ai.test.ts +561 -502
  174. package/src/ai.ts +1472 -1419
  175. package/src/build-api.coverage.test.ts +633 -633
  176. package/src/build-api.ts +846 -846
  177. package/src/builtin-editors.grid.test.ts +83 -83
  178. package/src/cell-formatting.ts +177 -171
  179. package/src/cell-render.test.ts +513 -513
  180. package/src/cell-render.ts +496 -496
  181. package/src/cell-values.ts +148 -148
  182. package/src/chart-export.test.ts +112 -0
  183. package/src/chart-export.ts +270 -202
  184. package/src/chart-view.svelte.ts +36 -36
  185. package/src/chart.test.ts +830 -1
  186. package/src/chart.ts +3342 -2321
  187. package/src/collaboration.test.ts +104 -104
  188. package/src/collaboration.ts +167 -167
  189. package/src/column-groups.ts +78 -78
  190. package/src/core.performance.test.ts +30 -30
  191. package/src/core.ts +1865 -1865
  192. package/src/createAutocomplete.svelte.ts +132 -132
  193. package/src/createCombobox.svelte.ts +191 -191
  194. package/src/createCountryInput.svelte.ts +157 -157
  195. package/src/createDropdownList.svelte.ts +168 -168
  196. package/src/createForm.svelte.ts +386 -386
  197. package/src/createGrid.svelte.ts +42 -42
  198. package/src/createGrid.test.ts +10 -10
  199. package/src/createGridState.svelte.ts +17 -17
  200. package/src/createListbox.svelte.ts +250 -250
  201. package/src/createMenu.svelte.ts +224 -224
  202. package/src/createPopoverSelect.svelte.ts +213 -213
  203. package/src/createSlider.svelte.ts +191 -191
  204. package/src/createTooltip.svelte.ts +144 -144
  205. package/src/createTree.svelte.ts +322 -322
  206. package/src/datetime/date-core.ts +206 -206
  207. package/src/datetime/date-restrict.ts +61 -61
  208. package/src/datetime/timezone.ts +135 -135
  209. package/src/dock-manager-model.ts +596 -596
  210. package/src/dock-model.ts +374 -374
  211. package/src/editing.test.ts +974 -974
  212. package/src/editing.ts +618 -609
  213. package/src/editor-contract.ts +171 -171
  214. package/src/editor-registry.grid.test.ts +144 -144
  215. package/src/editor-registry.ts +122 -122
  216. package/src/export-data-api.test.ts +126 -126
  217. package/src/export-format.test.ts +107 -107
  218. package/src/export-format.ts +601 -601
  219. package/src/filter-operators.ts +160 -160
  220. package/src/filtering/excel-filters.ts +325 -325
  221. package/src/flex-render.ts +3 -3
  222. package/src/form-field.ts +127 -127
  223. package/src/grid-icons.test.ts +46 -0
  224. package/src/grid-icons.ts +184 -0
  225. package/src/group-display.test.ts +167 -167
  226. package/src/group-display.ts +200 -200
  227. package/src/headless.ts +87 -87
  228. package/src/icon-overrides.grid.test.ts +188 -0
  229. package/src/icon-seam.test.ts +100 -0
  230. package/src/index.ts +19 -0
  231. package/src/js-scroller.svelte.ts +173 -173
  232. package/src/keyboard-handlers.ts +270 -270
  233. package/src/keyboard.test.ts +59 -59
  234. package/src/keyboard.ts +97 -97
  235. package/src/list-nav.test.ts +49 -49
  236. package/src/list-nav.ts +29 -29
  237. package/src/list-option.test.ts +56 -56
  238. package/src/list-option.ts +179 -179
  239. package/src/menus.ts +597 -597
  240. package/src/merge-objects.ts +48 -48
  241. package/src/overlays.test.ts +90 -90
  242. package/src/positioning.ts +268 -268
  243. package/src/render-component.ts +28 -28
  244. package/src/row-drag.test.ts +401 -401
  245. package/src/row-drag.ts +419 -419
  246. package/src/row-resize.test.ts +524 -524
  247. package/src/row-resize.ts +228 -228
  248. package/src/scheduler-ical.ts +181 -181
  249. package/src/scheduler-model.test.ts +562 -562
  250. package/src/scheduler-model.ts +873 -873
  251. package/src/selection.test.ts +885 -885
  252. package/src/server-data-source.test.ts +383 -383
  253. package/src/server-data-source.ts +469 -469
  254. package/src/sparkline.test.ts +68 -68
  255. package/src/sparkline.ts +169 -169
  256. package/src/spreadsheet.test.ts +488 -488
  257. package/src/spreadsheet.ts +312 -312
  258. package/src/static-functions.ts +11 -11
  259. package/src/subscribe.ts +38 -38
  260. package/src/summaries.ts +113 -113
  261. package/src/svgrid-wrapper.types.ts +563 -563
  262. package/src/svgrid.async-editor-options.test.ts +273 -273
  263. package/src/svgrid.auto-row-height.test.ts +204 -204
  264. package/src/svgrid.behavior.test.ts +910 -910
  265. package/src/svgrid.charting.test.ts +654 -534
  266. package/src/svgrid.comments-autocomplete.test.ts +127 -127
  267. package/src/svgrid.context-menu.test.ts +147 -147
  268. package/src/svgrid.features.test.ts +157 -157
  269. package/src/svgrid.filter-depth.test.ts +163 -163
  270. package/src/svgrid.filter-menu-listbox.svelte.test.ts +382 -377
  271. package/src/svgrid.filter-menu-scroll.test.ts +112 -112
  272. package/src/svgrid.grand-total.test.ts +188 -188
  273. package/src/svgrid.group-display-mode.test.ts +171 -171
  274. package/src/svgrid.group-footers.test.ts +121 -121
  275. package/src/svgrid.group-pagination.test.ts +153 -153
  276. package/src/svgrid.new-features.wrapper.test.ts +251 -251
  277. package/src/svgrid.tree-data.test.ts +186 -186
  278. package/src/svgrid.wrapper.test.ts +63 -63
  279. package/src/svgriddropdown.async-panel.svelte.test.ts +195 -195
  280. package/src/test-setup.ts +62 -62
  281. package/src/themes/index.ts +288 -288
  282. package/src/toast-store.svelte.ts +250 -250
  283. package/src/toast-store.test.ts +147 -147
  284. package/src/tree-row-model.test.ts +168 -168
  285. package/src/ui-buttons.test.ts +144 -144
  286. package/src/ui-inputs.test.ts +118 -118
  287. package/src/ui-localization.test.ts +113 -113
  288. package/src/ui-range.test.ts +70 -70
  289. package/src/ui-selection.test.ts +155 -155
  290. package/src/ui-tier1.test.ts +142 -142
  291. package/src/virtual.test.ts +88 -88
  292. package/src/virtualization/column-virtualizer.test.ts +27 -27
  293. package/src/virtualization/column-virtualizer.ts +30 -30
  294. package/src/virtualization/svelte-virtualizer.svelte.ts +26 -26
  295. package/src/virtualization/types.ts +30 -30
  296. package/src/virtualization/virtualizer.test.ts +47 -47
  297. package/src/virtualization/virtualizer.ts +322 -322
  298. package/dist/cdn/GridMenus-DMihUtma.js +0 -600
  299. package/dist/cdn/GridMenus-nmNDj1a3.js +0 -601
  300. package/dist/cdn/SvGridChart-Bs2GIR2Q.js +0 -1202
  301. package/dist/cdn/SvGridChart-CwhFz7GV.js +0 -1203
  302. package/dist/cdn/SvGridChartPanel-1WXuStzM.js +0 -561
  303. package/dist/cdn/SvGridChartPanel-e5_nqNP9.js +0 -585
  304. package/dist/cdn/chart-i4XcXyHJ.js +0 -1214
@@ -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'