@svgrid/grid 2.7.0 → 3.0.1

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 (264) 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 +181 -181
  5. package/dist/SvAutoComplete.svelte +169 -169
  6. package/dist/SvAvatar.svelte +75 -75
  7. package/dist/SvCalendar.svelte +503 -503
  8. package/dist/SvCarousel.svelte +141 -141
  9. package/dist/SvCheckBox.svelte +102 -102
  10. package/dist/SvCircularProgress.svelte +109 -109
  11. package/dist/SvColorInput.svelte +181 -181
  12. package/dist/SvComboBox.svelte +279 -279
  13. package/dist/SvContextMenu.svelte +116 -116
  14. package/dist/SvCountryInput.svelte +163 -163
  15. package/dist/SvDrawer.svelte +254 -254
  16. package/dist/SvDropDownList.svelte +378 -378
  17. package/dist/SvDurationInput.svelte +126 -126
  18. package/dist/SvField.svelte +293 -293
  19. package/dist/SvForm.svelte +437 -437
  20. package/dist/SvGridCellEditor.svelte +748 -744
  21. package/dist/SvGridChart.svelte +1716 -1716
  22. package/dist/SvGridChartPanel.svelte +485 -485
  23. package/dist/SvGridChartView.svelte +70 -70
  24. package/dist/SvGridDropdown.svelte +728 -728
  25. package/dist/SvGridSelect.svelte +270 -270
  26. package/dist/SvGroupCell.svelte +116 -116
  27. package/dist/SvListBox.svelte +334 -334
  28. package/dist/SvMaskedInput.svelte +122 -122
  29. package/dist/SvMenu.svelte +124 -124
  30. package/dist/SvMenuList.svelte +146 -146
  31. package/dist/SvMultiSelect.svelte +293 -293
  32. package/dist/SvNumberInput.svelte +172 -172
  33. package/dist/SvOtpInput.svelte +158 -158
  34. package/dist/SvPasswordInput.svelte +151 -151
  35. package/dist/SvPhoneInput.svelte +133 -133
  36. package/dist/SvPopover.svelte +197 -197
  37. package/dist/SvProgress.svelte +116 -116
  38. package/dist/SvRadioGroup.svelte +107 -107
  39. package/dist/SvRating.svelte +112 -112
  40. package/dist/SvResult.svelte +73 -73
  41. package/dist/SvRichText.svelte +211 -211
  42. package/dist/SvRowGroupPanel.svelte +170 -170
  43. package/dist/SvScrollArea.svelte +61 -61
  44. package/dist/SvSlider.svelte +203 -203
  45. package/dist/SvSwitchButton.svelte +108 -108
  46. package/dist/SvTagsInput.svelte +115 -115
  47. package/dist/SvTextInput.svelte +147 -147
  48. package/dist/SvTimePicker.svelte +245 -245
  49. package/dist/SvToaster.svelte +159 -159
  50. package/dist/SvToggleButton.svelte +85 -85
  51. package/dist/SvTooltip.svelte +161 -161
  52. package/dist/SvTour.svelte +208 -208
  53. package/dist/SvTree.svelte +444 -444
  54. package/dist/SvTreeSelect.svelte +239 -239
  55. package/dist/cdn/{GridMenus-C4oLsJyj.js → GridMenus-CYzOvmNQ.js} +3 -3
  56. package/dist/cdn/{GridMenus-yEivjNwl.js → GridMenus-DFB6iwF8.js} +3 -3
  57. package/dist/cdn/{SvDateRangeInput-DflbiP7N.js → SvDateRangeInput-CaOuMs8O.js} +1 -1
  58. package/dist/cdn/{SvDateRangeInput-Bh0A0JkF.js → SvDateRangeInput-DMLKmGEc.js} +1 -1
  59. package/dist/cdn/{SvDateTimePicker-Bivn8dAP.js → SvDateTimePicker-CCbDZNZB.js} +1 -1
  60. package/dist/cdn/{SvDateTimePicker-BWwpfB_o.js → SvDateTimePicker-sonaH0oh.js} +1 -1
  61. package/dist/cdn/{SvGridCellEditor-Ba7rY3eu.js → SvGridCellEditor-BWnTi2N7.js} +2 -2
  62. package/dist/cdn/{SvGridCellEditor-AXL8cHGO.js → SvGridCellEditor-CjEJMJKc.js} +2 -2
  63. package/dist/cdn/{SvGridChart-CwhFz7GV.js → SvGridChart-BEJmNNx9.js} +1 -1
  64. package/dist/cdn/{SvGridChart-Bs2GIR2Q.js → SvGridChart-BwVos976.js} +1 -1
  65. package/dist/cdn/{SvGridChartPanel-1WXuStzM.js → SvGridChartPanel-BOknOkrP.js} +1 -1
  66. package/dist/cdn/{SvGridChartPanel-e5_nqNP9.js → SvGridChartPanel-D2PjII4O.js} +1 -1
  67. package/dist/cdn/{SvGridChartView-SmPW10dI.js → SvGridChartView-00LPUHL1.js} +1 -1
  68. package/dist/cdn/{SvGridChartView-eSPuJE6g.js → SvGridChartView-BhUEJ5ki.js} +1 -1
  69. package/dist/cdn/{SvGridDropdown-B1ZcLpgs.js → SvGridDropdown-D0VdjeR8.js} +1 -1
  70. package/dist/cdn/{SvGridDropdown-CtdbHcIS.js → SvGridDropdown-D13MtJ2j.js} +1 -1
  71. package/dist/cdn/{date-format-DZT7T1wf.js → date-format-BNii4zeD.js} +2 -2
  72. package/dist/cdn/{date-format-CcP1tafP.js → date-format-BnnHlqGw.js} +2 -2
  73. package/dist/cdn/{row-drag-touch-Ddaa-QeB.js → row-drag-touch-CycRR65n.js} +12 -10
  74. package/dist/cdn/{src-COC0vnpg.js → src-C8QjSaq-.js} +53 -55
  75. package/dist/cdn/{src-pYGV2rMR.js → src-D0hO2eYN.js} +52 -54
  76. package/dist/cdn/svgrid.js +7 -7
  77. package/dist/cdn/svgrid.svelte-external.js +7 -7
  78. package/dist/chart-export.js +8 -8
  79. package/dist/editing.js +22 -13
  80. package/dist/row-drag-touch.d.ts +5 -1
  81. package/dist/row-drag-touch.js +15 -4
  82. package/dist/row-drag.js +7 -3
  83. package/package.json +11 -11
  84. package/src/FlexRender.svelte +96 -96
  85. package/src/GridFooter.svelte +181 -181
  86. package/src/SvAutoComplete.svelte +169 -169
  87. package/src/SvAvatar.svelte +75 -75
  88. package/src/SvCalendar.svelte +503 -503
  89. package/src/SvCalendar.test.ts +226 -226
  90. package/src/SvCarousel.svelte +141 -141
  91. package/src/SvCheckBox.svelte +102 -102
  92. package/src/SvCircularProgress.svelte +109 -109
  93. package/src/SvColorInput.svelte +181 -181
  94. package/src/SvComboBox.svelte +279 -279
  95. package/src/SvContextMenu.svelte +116 -116
  96. package/src/SvCountryInput.svelte +163 -163
  97. package/src/SvDrawer.svelte +254 -254
  98. package/src/SvDropDownList.svelte +378 -378
  99. package/src/SvDurationInput.svelte +126 -126
  100. package/src/SvField.svelte +293 -293
  101. package/src/SvForm.svelte +437 -437
  102. package/src/SvForm.test.ts +411 -411
  103. package/src/SvGrid.types.ts +2092 -2092
  104. package/src/SvGridCellEditor.svelte +748 -744
  105. package/src/SvGridChart.svelte +1716 -1716
  106. package/src/SvGridChartPanel.svelte +485 -485
  107. package/src/SvGridChartView.svelte +70 -70
  108. package/src/SvGridDropdown.svelte +728 -728
  109. package/src/SvGridSelect.svelte +270 -270
  110. package/src/SvGroupCell.svelte +116 -116
  111. package/src/SvListBox.svelte +334 -334
  112. package/src/SvMaskedInput.svelte +122 -122
  113. package/src/SvMenu.svelte +124 -124
  114. package/src/SvMenu.test.ts +97 -97
  115. package/src/SvMenuList.svelte +146 -146
  116. package/src/SvMultiSelect.svelte +293 -293
  117. package/src/SvNumberInput.svelte +172 -172
  118. package/src/SvOtpInput.svelte +158 -158
  119. package/src/SvPasswordInput.svelte +151 -151
  120. package/src/SvPhoneInput.svelte +133 -133
  121. package/src/SvPopover.svelte +197 -197
  122. package/src/SvProgress.svelte +116 -116
  123. package/src/SvRadioGroup.svelte +107 -107
  124. package/src/SvRating.svelte +112 -112
  125. package/src/SvResult.svelte +73 -73
  126. package/src/SvRichText.svelte +211 -211
  127. package/src/SvRowGroupPanel.svelte +170 -170
  128. package/src/SvScrollArea.svelte +61 -61
  129. package/src/SvSlider.svelte +203 -203
  130. package/src/SvSwitchButton.svelte +108 -108
  131. package/src/SvTagsInput.svelte +115 -115
  132. package/src/SvTextInput.svelte +147 -147
  133. package/src/SvTimePicker.svelte +245 -245
  134. package/src/SvToaster.svelte +159 -159
  135. package/src/SvToaster.test.ts +95 -95
  136. package/src/SvToggleButton.svelte +85 -85
  137. package/src/SvTooltip.svelte +161 -161
  138. package/src/SvTour.svelte +208 -208
  139. package/src/SvTree.svelte +444 -444
  140. package/src/SvTreeSelect.svelte +239 -239
  141. package/src/a11y/dismissable.test.ts +119 -119
  142. package/src/a11y/dismissable.ts +114 -114
  143. package/src/a11y.contract.test.ts +49 -49
  144. package/src/a11y.test.ts +59 -59
  145. package/src/a11y.ts +61 -61
  146. package/src/ai.test.ts +502 -502
  147. package/src/ai.ts +1419 -1419
  148. package/src/build-api.coverage.test.ts +633 -633
  149. package/src/build-api.ts +846 -846
  150. package/src/builtin-editors.grid.test.ts +83 -83
  151. package/src/cell-formatting.ts +171 -171
  152. package/src/cell-render.test.ts +513 -513
  153. package/src/cell-render.ts +496 -496
  154. package/src/cell-values.ts +148 -148
  155. package/src/chart-export.ts +202 -202
  156. package/src/chart-view.svelte.ts +36 -36
  157. package/src/chart.ts +2321 -2321
  158. package/src/collaboration.test.ts +104 -104
  159. package/src/collaboration.ts +167 -167
  160. package/src/column-groups.ts +78 -78
  161. package/src/core.performance.test.ts +30 -30
  162. package/src/core.ts +1865 -1865
  163. package/src/createAutocomplete.svelte.ts +132 -132
  164. package/src/createCombobox.svelte.ts +191 -191
  165. package/src/createCountryInput.svelte.ts +157 -157
  166. package/src/createDropdownList.svelte.ts +168 -168
  167. package/src/createForm.svelte.ts +386 -386
  168. package/src/createGrid.svelte.ts +42 -42
  169. package/src/createGrid.test.ts +10 -10
  170. package/src/createGridState.svelte.ts +17 -17
  171. package/src/createListbox.svelte.ts +250 -250
  172. package/src/createMenu.svelte.ts +224 -224
  173. package/src/createPopoverSelect.svelte.ts +213 -213
  174. package/src/createSlider.svelte.ts +191 -191
  175. package/src/createTooltip.svelte.ts +144 -144
  176. package/src/createTree.svelte.ts +322 -322
  177. package/src/datetime/date-core.ts +206 -206
  178. package/src/datetime/date-restrict.ts +61 -61
  179. package/src/datetime/timezone.ts +135 -135
  180. package/src/dock-manager-model.ts +596 -596
  181. package/src/dock-model.ts +374 -374
  182. package/src/editing.test.ts +974 -974
  183. package/src/editing.ts +618 -609
  184. package/src/editor-contract.ts +171 -171
  185. package/src/editor-registry.grid.test.ts +144 -144
  186. package/src/editor-registry.ts +122 -122
  187. package/src/export-data-api.test.ts +126 -126
  188. package/src/export-format.test.ts +107 -107
  189. package/src/export-format.ts +601 -601
  190. package/src/filter-operators.ts +160 -160
  191. package/src/filtering/excel-filters.ts +325 -325
  192. package/src/flex-render.ts +3 -3
  193. package/src/form-field.ts +127 -127
  194. package/src/group-display.test.ts +167 -167
  195. package/src/group-display.ts +200 -200
  196. package/src/headless.ts +87 -87
  197. package/src/js-scroller.svelte.ts +173 -173
  198. package/src/keyboard-handlers.ts +270 -270
  199. package/src/keyboard.test.ts +59 -59
  200. package/src/keyboard.ts +97 -97
  201. package/src/list-nav.test.ts +49 -49
  202. package/src/list-nav.ts +29 -29
  203. package/src/list-option.test.ts +56 -56
  204. package/src/list-option.ts +179 -179
  205. package/src/menus.ts +597 -597
  206. package/src/merge-objects.ts +48 -48
  207. package/src/overlays.test.ts +90 -90
  208. package/src/positioning.ts +268 -268
  209. package/src/render-component.ts +28 -28
  210. package/src/row-drag-touch.ts +226 -211
  211. package/src/row-drag.test.ts +401 -353
  212. package/src/row-drag.ts +419 -415
  213. package/src/row-resize.test.ts +524 -524
  214. package/src/row-resize.ts +228 -228
  215. package/src/scheduler-ical.ts +181 -181
  216. package/src/scheduler-model.test.ts +562 -562
  217. package/src/scheduler-model.ts +873 -873
  218. package/src/selection.test.ts +885 -885
  219. package/src/server-data-source.test.ts +383 -383
  220. package/src/server-data-source.ts +469 -469
  221. package/src/sparkline.test.ts +68 -68
  222. package/src/sparkline.ts +169 -169
  223. package/src/spreadsheet.test.ts +488 -488
  224. package/src/spreadsheet.ts +312 -312
  225. package/src/static-functions.ts +11 -11
  226. package/src/subscribe.ts +38 -38
  227. package/src/summaries.ts +113 -113
  228. package/src/svgrid-wrapper.types.ts +563 -563
  229. package/src/svgrid.async-editor-options.test.ts +273 -273
  230. package/src/svgrid.auto-row-height.test.ts +204 -204
  231. package/src/svgrid.behavior.test.ts +910 -910
  232. package/src/svgrid.charting.test.ts +534 -534
  233. package/src/svgrid.comments-autocomplete.test.ts +127 -127
  234. package/src/svgrid.context-menu.test.ts +147 -147
  235. package/src/svgrid.features.test.ts +157 -157
  236. package/src/svgrid.filter-depth.test.ts +163 -163
  237. package/src/svgrid.filter-menu-listbox.svelte.test.ts +382 -377
  238. package/src/svgrid.filter-menu-scroll.test.ts +112 -112
  239. package/src/svgrid.grand-total.test.ts +188 -188
  240. package/src/svgrid.group-display-mode.test.ts +171 -171
  241. package/src/svgrid.group-footers.test.ts +121 -121
  242. package/src/svgrid.group-pagination.test.ts +153 -153
  243. package/src/svgrid.new-features.wrapper.test.ts +251 -251
  244. package/src/svgrid.tree-data.test.ts +186 -186
  245. package/src/svgrid.wrapper.test.ts +63 -63
  246. package/src/svgriddropdown.async-panel.svelte.test.ts +195 -195
  247. package/src/test-setup.ts +62 -62
  248. package/src/themes/index.ts +288 -288
  249. package/src/toast-store.svelte.ts +250 -250
  250. package/src/toast-store.test.ts +147 -147
  251. package/src/tree-row-model.test.ts +168 -168
  252. package/src/ui-buttons.test.ts +144 -144
  253. package/src/ui-inputs.test.ts +118 -118
  254. package/src/ui-localization.test.ts +113 -113
  255. package/src/ui-range.test.ts +70 -70
  256. package/src/ui-selection.test.ts +155 -155
  257. package/src/ui-tier1.test.ts +142 -142
  258. package/src/virtual.test.ts +88 -88
  259. package/src/virtualization/column-virtualizer.test.ts +27 -27
  260. package/src/virtualization/column-virtualizer.ts +30 -30
  261. package/src/virtualization/svelte-virtualizer.svelte.ts +26 -26
  262. package/src/virtualization/types.ts +30 -30
  263. package/src/virtualization/virtualizer.test.ts +47 -47
  264. package/src/virtualization/virtualizer.ts +322 -322
@@ -1,279 +1,279 @@
1
- <script lang="ts">
2
- /**
3
- * SvComboBox - an editable combobox: type to filter a portalled list, pick an
4
- * option (value must come from the list). Parity: Smart `smart-combo-box`.
5
- * Controlled via `value` + `onChange`. On blur, unmatched text reverts.
6
- *
7
- * This is one styled renderer over the headless `createCombobox` core (state +
8
- * keyboard + ARIA); only portal/measure/scroll render concerns live here.
9
- */
10
- import { anchoredRect, portalToBody, popIn, type AnchoredRect } from './popover'
11
- import { startPanelResize } from './panel-resize'
12
- import { createDismissableLayer } from './a11y/dismissable'
13
- import { groupOptions, normalizeOptions, type ListOption } from './list-option'
14
- import SvField from './SvField.svelte'
15
- import { nextEditorId, resolveMessages, type SvEditorProps } from './editor-contract'
16
- import { createCombobox } from './createCombobox.svelte'
17
- import type { Snippet } from 'svelte'
18
-
19
- /** User-facing strings (localizable via `messages`). */
20
- type ComboMessages = { noResults: string; loading: string; typeMore: string }
21
- const DEFAULT_MESSAGES: ComboMessages = { noResults: 'No matches', loading: 'Loading...', typeMore: 'Type to search' }
22
-
23
- type Props = SvEditorProps & {
24
- options?: ReadonlyArray<ListOption>
25
- value?: string | number | null
26
- onChange?: (value: string | number | null) => void
27
- placeholder?: string
28
- autoOpen?: boolean
29
- /** Show a clear (x) button when a value is selected. */
30
- clearable?: boolean
31
- /** Show a bottom drag grip so the user can resize the open panel's height
32
- * (hidden when the panel flips upward, where there is no room to grow). */
33
- resizable?: boolean
34
- /** Load options from a server as the user types (debounced). Disables local
35
- * filtering; the returned list is shown as-is. */
36
- loadOptions?: (query: string) => Promise<ListOption[]>
37
- /** Min chars before a remote search fires. Default 1. */
38
- minLength?: number
39
- /** Debounce (ms) before a remote search fires. Default 250. */
40
- debounce?: number
41
- /** Override the built-in strings (empty-state / loading text). */
42
- messages?: Partial<ComboMessages>
43
- /** Custom render for each option (receives the ListOption). */
44
- item?: Snippet<[ListOption]>
45
- /** Content pinned above the option list. */
46
- header?: Snippet
47
- /** Content pinned below the option list. */
48
- footer?: Snippet
49
- /** Shown when the (non-loading) list is empty; overrides the default text. */
50
- noData?: Snippet
51
- }
52
-
53
- let {
54
- options = [],
55
- value = null,
56
- onChange,
57
- placeholder = 'Select…',
58
- disabled = false,
59
- readonly = false,
60
- clearable = false,
61
- resizable = false,
62
- name,
63
- size = 'md',
64
- ariaLabel,
65
- invalid = false,
66
- block = false,
67
- required = false,
68
- error,
69
- label,
70
- hint,
71
- dir,
72
- id,
73
- loading: loadingProp = false,
74
- autoOpen = false,
75
- loadOptions,
76
- minLength = 1,
77
- debounce = 250,
78
- messages,
79
- item,
80
- header,
81
- footer,
82
- noData,
83
- }: Props = $props()
84
-
85
- const autoId = nextEditorId('sv-combo')
86
- const uid = $derived(id ?? autoId)
87
- const M = $derived(resolveMessages(DEFAULT_MESSAGES, messages))
88
-
89
- let inputEl = $state<HTMLInputElement | null>(null)
90
- let fieldEl = $state<HTMLDivElement | null>(null)
91
- let panelEl = $state<HTMLDivElement | null>(null)
92
- let rect = $state<AnchoredRect>({ top: 0, left: 0, width: 0, openUpward: false, maxHeight: 0, availHeight: 0 })
93
- // User-chosen panel height (px) once they drag the resize grip; null = auto.
94
- let userHeight = $state<number | null>(null)
95
- // Default comfortable cap (px) before the list scrolls; the grip can grow past it.
96
- const DEFAULT_CAP = 288
97
- const panelMaxH = $derived(
98
- resizable && userHeight != null ? Math.min(userHeight, rect.availHeight) : Math.min(rect.availHeight, DEFAULT_CAP),
99
- )
100
- const showGrip = $derived(resizable && !rect.openUpward)
101
-
102
- // Remote data source: fetch options as the query changes (debounced).
103
- let remoteOptions = $state<ListOption[]>([])
104
- let loading = $state(false)
105
- let searched = $state(false)
106
- let debTimer: ReturnType<typeof setTimeout> | undefined
107
- let reqSeq = 0
108
- const effectiveOptions = $derived(normalizeOptions(loadOptions ? remoteOptions : options))
109
-
110
- const combo = createCombobox({
111
- options: () => effectiveOptions,
112
- value: () => value,
113
- onChange: (v) => onChange?.(v),
114
- disabled: () => disabled,
115
- readonly: () => readonly,
116
- ariaLabel: () => ariaLabel,
117
- localFilter: () => !loadOptions,
118
- focusInput: () => inputEl?.focus(),
119
- blurInput: () => inputEl?.blur(),
120
- id: () => uid,
121
- invalid: () => invalid,
122
- required: () => required,
123
- error: () => error,
124
- hint: () => hint,
125
- })
126
-
127
- // Debounced remote search driven by the combobox query while editing.
128
- $effect(() => {
129
- if (!loadOptions) return
130
- const q = combo.editing ? combo.query : ''
131
- if (debTimer) clearTimeout(debTimer)
132
- if (q.trim().length < minLength) { remoteOptions = []; loading = false; searched = false; return }
133
- loading = true
134
- const seq = ++reqSeq
135
- debTimer = setTimeout(async () => {
136
- try {
137
- const res = await loadOptions!(q.trim())
138
- if (seq === reqSeq) { remoteOptions = res; searched = true }
139
- } finally {
140
- if (seq === reqSeq) loading = false
141
- }
142
- }, debounce)
143
- })
144
-
145
- function updatePos() {
146
- if (!fieldEl) return
147
- // estimatedHeight only picks the flip direction (up vs down); the panel's
148
- // real max-height comes from availHeight below, so it takes its natural
149
- // content height (options + group labels) and scrolls only when it truly
150
- // overflows the room - never from an estimate that under-counts a row. When
151
- // the user has dragged the grip, anchor the flip decision to THAT height.
152
- const est = resizable && userHeight != null ? userHeight : Math.min(combo.filtered.length, 8) * 34 + 12
153
- rect = anchoredRect(fieldEl.getBoundingClientRect(), { estimatedHeight: est })
154
- }
155
-
156
- function startResize(e: PointerEvent) {
157
- if (!panelEl) return
158
- startPanelResize(e, {
159
- startHeight: panelEl.clientHeight,
160
- min: 96,
161
- max: () => rect.availHeight,
162
- onHeight: (h) => { userHeight = h; updatePos() },
163
- })
164
- }
165
-
166
- // Position + reposition + outside-click close are render concerns (need the DOM).
167
- $effect(() => {
168
- if (!combo.open) return
169
- updatePos()
170
- const rp = () => updatePos()
171
- window.addEventListener('scroll', rp, true); window.addEventListener('resize', rp)
172
- const layer = createDismissableLayer({ element: () => [fieldEl, panelEl], onDismiss: () => combo.close(), closeOnEscape: false })
173
- layer.activate()
174
- return () => { window.removeEventListener('scroll', rp, true); window.removeEventListener('resize', rp); layer.release() }
175
- })
176
- // Keep the active option scrolled into view (render concern).
177
- $effect(() => {
178
- if (!combo.open) return
179
- const i = combo.activeIndex
180
- queueMicrotask(() => panelEl?.querySelector<HTMLElement>(`[data-idx="${i}"]`)?.scrollIntoView({ block: 'nearest' }))
181
- })
182
- function focusOpen(node: HTMLInputElement) { if (autoOpen) { node.focus() } }
183
- </script>
184
-
185
- <SvField id={uid} {label} {hint} {error} {required} {dir} loading={loadingProp || loading}>
186
- <div bind:this={fieldEl} class="sv-combo sv-combo--{size}"
187
- class:is-block={block} class:is-open={combo.open} class:is-disabled={disabled} class:is-invalid={invalid}>
188
- <input
189
- bind:this={inputEl}
190
- class="sv-combo__input"
191
- type="text"
192
- {placeholder}
193
- {...combo.inputProps()}
194
- use:focusOpen
195
- />
196
- {#if clearable && combo.value != null && !disabled && !readonly}
197
- <button type="button" class="sv-combo__clear" tabindex="-1" aria-label="Clear" onclick={() => { combo.clear(); inputEl?.focus() }}>
198
- <svg viewBox="0 0 24 24" width="13" height="13" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"><path d="M6 6l12 12M18 6L6 18" /></svg>
199
- </button>
200
- {/if}
201
- <button class="sv-combo__chev" {...combo.triggerProps()}>
202
- <svg viewBox="0 0 24 24" width="15" height="15" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="m6 9 6 6 6-6" /></svg>
203
- </button>
204
- </div>
205
- </SvField>
206
-
207
- {#if combo.open}
208
- <div bind:this={panelEl} class="sv-ddl__panel" class:is-resizable={showGrip} use:portalToBody use:popIn={{ up: rect.openUpward }} style:position="fixed" style:top={rect.openUpward ? undefined : `${rect.top}px`} style:bottom={rect.openUpward ? `${rect.bottom}px` : undefined} style:left={`${rect.left}px`} style:min-width={`${rect.width}px`} style:max-height={`${panelMaxH}px`} style:height={resizable && userHeight != null && !rect.openUpward ? `${panelMaxH}px` : undefined} {...combo.listboxProps()}>
209
- {#if header}<div class="sv-ddl__header">{@render header()}</div>{/if}
210
- {#if loading}
211
- <div class="sv-ddl__empty sv-ddl__loading"><svg class="sv-ddl__spin" viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"><path d="M21 12a9 9 0 1 1-6.2-8.6" /></svg>{M.loading}</div>
212
- {:else if loadOptions && !searched && combo.query.trim().length < minLength}
213
- <div class="sv-ddl__empty">{M.typeMore}</div>
214
- {:else if combo.filtered.length}
215
- {#each groupOptions(combo.filtered) as g (g.group ?? ' ')}
216
- {#if g.group != null}<div class="sv-ddl__group-label" aria-hidden="true">{g.group}</div>{/if}
217
- {#each g.options as opt (opt.index)}
218
- <!-- svelte-ignore a11y_click_events_have_key_events a11y_interactive_supports_focus -->
219
- <div class="sv-ddl__opt" class:is-active={combo.isActive(opt.index)} class:is-selected={combo.isSelected(opt)} class:is-disabled={opt.disabled} {...combo.optionProps(opt.index)}>{#if item}{@render item(opt)}{:else}{opt.label}{/if}</div>
220
- {/each}
221
- {/each}
222
- {:else if noData}
223
- {@render noData()}
224
- {:else}
225
- <div class="sv-ddl__empty">{M.noResults}</div>
226
- {/if}
227
- {#if footer}<div class="sv-ddl__footer">{@render footer()}</div>{/if}
228
- {#if showGrip}
229
- <!-- svelte-ignore a11y_no_static_element_interactions -->
230
- <div class="sv-ddl__grip" onpointerdown={startResize} title="Drag to resize" aria-hidden="true">
231
- <span class="sv-ddl__grip-dots"></span>
232
- </div>
233
- {/if}
234
- </div>
235
- {/if}
236
- {#if name}<input type="hidden" {name} value={value ?? ''} />{/if}
237
-
238
- <style>
239
- .sv-combo {
240
- --_accent: var(--sg-accent, #2563eb);
241
- display: inline-flex; align-items: center; width: 200px;
242
- background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a);
243
- border: 1px solid var(--sg-input-border, var(--sg-border, #cbd5e1)); border-radius: var(--sg-radius, 8px);
244
- }
245
- .sv-combo--sm { height: 28px; font-size: 12px; }
246
- .sv-combo--md { height: 34px; font-size: 13px; }
247
- .sv-combo--lg { height: 40px; font-size: 15px; }
248
- .sv-combo.is-open, .sv-combo:focus-within { border-color: var(--_accent); box-shadow: 0 0 0 2px color-mix(in srgb, var(--_accent) 22%, transparent); }
249
- .sv-combo.is-invalid { border-color: var(--sg-danger, #dc2626); }
250
- .sv-combo.is-invalid.is-open, .sv-combo.is-invalid:focus-within { box-shadow: 0 0 0 2px color-mix(in srgb, var(--sg-danger, #dc2626) 22%, transparent); }
251
- .sv-combo.is-disabled { opacity: 0.6; }
252
- .sv-combo__input { flex: 1; min-width: 0; border: 0; background: none; outline: none; color: inherit; font: inherit; padding-block: 0; padding-inline: 10px 4px; }
253
- .sv-combo__clear { display: grid; place-items: center; width: 22px; align-self: center; flex: none; background: none; border: 0; color: var(--sg-muted, #64748b); cursor: pointer; border-radius: 4px; }
254
- .sv-combo__clear:hover { color: var(--sg-danger, #dc2626); }
255
- .sv-combo__chev { display: grid; place-items: center; width: 28px; align-self: stretch; background: none; border: 0; color: var(--sg-muted, #64748b); cursor: pointer; }
256
- :global(.sv-ddl__empty) { padding: 8px 10px; color: var(--sg-muted, #94a3b8); font-size: 13px; }
257
- :global(.sv-ddl__header) { padding: 8px 10px; border-bottom: 1px solid var(--sg-border, #e2e8f0); font-size: 12.5px; color: var(--sg-muted, #64748b); }
258
- :global(.sv-ddl__footer) { padding: 8px 10px; border-top: 1px solid var(--sg-border, #e2e8f0); font-size: 12.5px; }
259
- :global(.sv-ddl__loading) { display: flex; align-items: center; gap: 7px; }
260
- :global(.sv-ddl__spin) { animation: sv-combo-spin 0.7s linear infinite; }
261
- @keyframes sv-combo-spin { to { transform: rotate(360deg); } }
262
- @media (prefers-reduced-motion: reduce) { :global(.sv-ddl__spin) { animation: none; } }
263
- /* Bottom resize grip (shared "····" handle - see SvDropDownList / panel-resize). */
264
- :global(.sv-ddl__panel.is-resizable) { padding-bottom: 0; }
265
- :global(.sv-ddl__grip) {
266
- position: sticky; bottom: 0; z-index: 1; margin: 2px -4px -4px; height: 15px;
267
- display: flex; align-items: center; justify-content: center; cursor: ns-resize;
268
- background: var(--sg-bg, #fff); border-top: 1px solid var(--sg-border, #e2e8f0);
269
- border-radius: 0 0 10px 10px; touch-action: none;
270
- }
271
- :global(.sv-ddl__grip-dots) {
272
- width: 26px; height: 4px; color: var(--sg-muted, #94a3b8); opacity: 0.6;
273
- background-image: radial-gradient(currentColor 1px, transparent 1.6px);
274
- background-size: 6px 4px; background-position: center; background-repeat: repeat-x;
275
- }
276
- :global(.sv-ddl__grip:hover .sv-ddl__grip-dots) { opacity: 1; }
277
- /* Fill the container - see `block` in SvEditorProps. */
278
- .sv-combo.is-block { width: 100%; max-width: 100%; }
279
- </style>
1
+ <script lang="ts">
2
+ /**
3
+ * SvComboBox - an editable combobox: type to filter a portalled list, pick an
4
+ * option (value must come from the list). Parity: Smart `smart-combo-box`.
5
+ * Controlled via `value` + `onChange`. On blur, unmatched text reverts.
6
+ *
7
+ * This is one styled renderer over the headless `createCombobox` core (state +
8
+ * keyboard + ARIA); only portal/measure/scroll render concerns live here.
9
+ */
10
+ import { anchoredRect, portalToBody, popIn, type AnchoredRect } from './popover'
11
+ import { startPanelResize } from './panel-resize'
12
+ import { createDismissableLayer } from './a11y/dismissable'
13
+ import { groupOptions, normalizeOptions, type ListOption } from './list-option'
14
+ import SvField from './SvField.svelte'
15
+ import { nextEditorId, resolveMessages, type SvEditorProps } from './editor-contract'
16
+ import { createCombobox } from './createCombobox.svelte'
17
+ import type { Snippet } from 'svelte'
18
+
19
+ /** User-facing strings (localizable via `messages`). */
20
+ type ComboMessages = { noResults: string; loading: string; typeMore: string }
21
+ const DEFAULT_MESSAGES: ComboMessages = { noResults: 'No matches', loading: 'Loading...', typeMore: 'Type to search' }
22
+
23
+ type Props = SvEditorProps & {
24
+ options?: ReadonlyArray<ListOption>
25
+ value?: string | number | null
26
+ onChange?: (value: string | number | null) => void
27
+ placeholder?: string
28
+ autoOpen?: boolean
29
+ /** Show a clear (x) button when a value is selected. */
30
+ clearable?: boolean
31
+ /** Show a bottom drag grip so the user can resize the open panel's height
32
+ * (hidden when the panel flips upward, where there is no room to grow). */
33
+ resizable?: boolean
34
+ /** Load options from a server as the user types (debounced). Disables local
35
+ * filtering; the returned list is shown as-is. */
36
+ loadOptions?: (query: string) => Promise<ListOption[]>
37
+ /** Min chars before a remote search fires. Default 1. */
38
+ minLength?: number
39
+ /** Debounce (ms) before a remote search fires. Default 250. */
40
+ debounce?: number
41
+ /** Override the built-in strings (empty-state / loading text). */
42
+ messages?: Partial<ComboMessages>
43
+ /** Custom render for each option (receives the ListOption). */
44
+ item?: Snippet<[ListOption]>
45
+ /** Content pinned above the option list. */
46
+ header?: Snippet
47
+ /** Content pinned below the option list. */
48
+ footer?: Snippet
49
+ /** Shown when the (non-loading) list is empty; overrides the default text. */
50
+ noData?: Snippet
51
+ }
52
+
53
+ let {
54
+ options = [],
55
+ value = null,
56
+ onChange,
57
+ placeholder = 'Select…',
58
+ disabled = false,
59
+ readonly = false,
60
+ clearable = false,
61
+ resizable = false,
62
+ name,
63
+ size = 'md',
64
+ ariaLabel,
65
+ invalid = false,
66
+ block = false,
67
+ required = false,
68
+ error,
69
+ label,
70
+ hint,
71
+ dir,
72
+ id,
73
+ loading: loadingProp = false,
74
+ autoOpen = false,
75
+ loadOptions,
76
+ minLength = 1,
77
+ debounce = 250,
78
+ messages,
79
+ item,
80
+ header,
81
+ footer,
82
+ noData,
83
+ }: Props = $props()
84
+
85
+ const autoId = nextEditorId('sv-combo')
86
+ const uid = $derived(id ?? autoId)
87
+ const M = $derived(resolveMessages(DEFAULT_MESSAGES, messages))
88
+
89
+ let inputEl = $state<HTMLInputElement | null>(null)
90
+ let fieldEl = $state<HTMLDivElement | null>(null)
91
+ let panelEl = $state<HTMLDivElement | null>(null)
92
+ let rect = $state<AnchoredRect>({ top: 0, left: 0, width: 0, openUpward: false, maxHeight: 0, availHeight: 0 })
93
+ // User-chosen panel height (px) once they drag the resize grip; null = auto.
94
+ let userHeight = $state<number | null>(null)
95
+ // Default comfortable cap (px) before the list scrolls; the grip can grow past it.
96
+ const DEFAULT_CAP = 288
97
+ const panelMaxH = $derived(
98
+ resizable && userHeight != null ? Math.min(userHeight, rect.availHeight) : Math.min(rect.availHeight, DEFAULT_CAP),
99
+ )
100
+ const showGrip = $derived(resizable && !rect.openUpward)
101
+
102
+ // Remote data source: fetch options as the query changes (debounced).
103
+ let remoteOptions = $state<ListOption[]>([])
104
+ let loading = $state(false)
105
+ let searched = $state(false)
106
+ let debTimer: ReturnType<typeof setTimeout> | undefined
107
+ let reqSeq = 0
108
+ const effectiveOptions = $derived(normalizeOptions(loadOptions ? remoteOptions : options))
109
+
110
+ const combo = createCombobox({
111
+ options: () => effectiveOptions,
112
+ value: () => value,
113
+ onChange: (v) => onChange?.(v),
114
+ disabled: () => disabled,
115
+ readonly: () => readonly,
116
+ ariaLabel: () => ariaLabel,
117
+ localFilter: () => !loadOptions,
118
+ focusInput: () => inputEl?.focus(),
119
+ blurInput: () => inputEl?.blur(),
120
+ id: () => uid,
121
+ invalid: () => invalid,
122
+ required: () => required,
123
+ error: () => error,
124
+ hint: () => hint,
125
+ })
126
+
127
+ // Debounced remote search driven by the combobox query while editing.
128
+ $effect(() => {
129
+ if (!loadOptions) return
130
+ const q = combo.editing ? combo.query : ''
131
+ if (debTimer) clearTimeout(debTimer)
132
+ if (q.trim().length < minLength) { remoteOptions = []; loading = false; searched = false; return }
133
+ loading = true
134
+ const seq = ++reqSeq
135
+ debTimer = setTimeout(async () => {
136
+ try {
137
+ const res = await loadOptions!(q.trim())
138
+ if (seq === reqSeq) { remoteOptions = res; searched = true }
139
+ } finally {
140
+ if (seq === reqSeq) loading = false
141
+ }
142
+ }, debounce)
143
+ })
144
+
145
+ function updatePos() {
146
+ if (!fieldEl) return
147
+ // estimatedHeight only picks the flip direction (up vs down); the panel's
148
+ // real max-height comes from availHeight below, so it takes its natural
149
+ // content height (options + group labels) and scrolls only when it truly
150
+ // overflows the room - never from an estimate that under-counts a row. When
151
+ // the user has dragged the grip, anchor the flip decision to THAT height.
152
+ const est = resizable && userHeight != null ? userHeight : Math.min(combo.filtered.length, 8) * 34 + 12
153
+ rect = anchoredRect(fieldEl.getBoundingClientRect(), { estimatedHeight: est })
154
+ }
155
+
156
+ function startResize(e: PointerEvent) {
157
+ if (!panelEl) return
158
+ startPanelResize(e, {
159
+ startHeight: panelEl.clientHeight,
160
+ min: 96,
161
+ max: () => rect.availHeight,
162
+ onHeight: (h) => { userHeight = h; updatePos() },
163
+ })
164
+ }
165
+
166
+ // Position + reposition + outside-click close are render concerns (need the DOM).
167
+ $effect(() => {
168
+ if (!combo.open) return
169
+ updatePos()
170
+ const rp = () => updatePos()
171
+ window.addEventListener('scroll', rp, true); window.addEventListener('resize', rp)
172
+ const layer = createDismissableLayer({ element: () => [fieldEl, panelEl], onDismiss: () => combo.close(), closeOnEscape: false })
173
+ layer.activate()
174
+ return () => { window.removeEventListener('scroll', rp, true); window.removeEventListener('resize', rp); layer.release() }
175
+ })
176
+ // Keep the active option scrolled into view (render concern).
177
+ $effect(() => {
178
+ if (!combo.open) return
179
+ const i = combo.activeIndex
180
+ queueMicrotask(() => panelEl?.querySelector<HTMLElement>(`[data-idx="${i}"]`)?.scrollIntoView({ block: 'nearest' }))
181
+ })
182
+ function focusOpen(node: HTMLInputElement) { if (autoOpen) { node.focus() } }
183
+ </script>
184
+
185
+ <SvField id={uid} {label} {hint} {error} {required} {dir} loading={loadingProp || loading}>
186
+ <div bind:this={fieldEl} class="sv-combo sv-combo--{size}"
187
+ class:is-block={block} class:is-open={combo.open} class:is-disabled={disabled} class:is-invalid={invalid}>
188
+ <input
189
+ bind:this={inputEl}
190
+ class="sv-combo__input"
191
+ type="text"
192
+ {placeholder}
193
+ {...combo.inputProps()}
194
+ use:focusOpen
195
+ />
196
+ {#if clearable && combo.value != null && !disabled && !readonly}
197
+ <button type="button" class="sv-combo__clear" tabindex="-1" aria-label="Clear" onclick={() => { combo.clear(); inputEl?.focus() }}>
198
+ <svg viewBox="0 0 24 24" width="13" height="13" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"><path d="M6 6l12 12M18 6L6 18" /></svg>
199
+ </button>
200
+ {/if}
201
+ <button class="sv-combo__chev" {...combo.triggerProps()}>
202
+ <svg viewBox="0 0 24 24" width="15" height="15" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="m6 9 6 6 6-6" /></svg>
203
+ </button>
204
+ </div>
205
+ </SvField>
206
+
207
+ {#if combo.open}
208
+ <div bind:this={panelEl} class="sv-ddl__panel" class:is-resizable={showGrip} use:portalToBody use:popIn={{ up: rect.openUpward }} style:position="fixed" style:top={rect.openUpward ? undefined : `${rect.top}px`} style:bottom={rect.openUpward ? `${rect.bottom}px` : undefined} style:left={`${rect.left}px`} style:min-width={`${rect.width}px`} style:max-height={`${panelMaxH}px`} style:height={resizable && userHeight != null && !rect.openUpward ? `${panelMaxH}px` : undefined} {...combo.listboxProps()}>
209
+ {#if header}<div class="sv-ddl__header">{@render header()}</div>{/if}
210
+ {#if loading}
211
+ <div class="sv-ddl__empty sv-ddl__loading"><svg class="sv-ddl__spin" viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"><path d="M21 12a9 9 0 1 1-6.2-8.6" /></svg>{M.loading}</div>
212
+ {:else if loadOptions && !searched && combo.query.trim().length < minLength}
213
+ <div class="sv-ddl__empty">{M.typeMore}</div>
214
+ {:else if combo.filtered.length}
215
+ {#each groupOptions(combo.filtered) as g (g.group ?? ' ')}
216
+ {#if g.group != null}<div class="sv-ddl__group-label" aria-hidden="true">{g.group}</div>{/if}
217
+ {#each g.options as opt (opt.index)}
218
+ <!-- svelte-ignore a11y_click_events_have_key_events a11y_interactive_supports_focus -->
219
+ <div class="sv-ddl__opt" class:is-active={combo.isActive(opt.index)} class:is-selected={combo.isSelected(opt)} class:is-disabled={opt.disabled} {...combo.optionProps(opt.index)}>{#if item}{@render item(opt)}{:else}{opt.label}{/if}</div>
220
+ {/each}
221
+ {/each}
222
+ {:else if noData}
223
+ {@render noData()}
224
+ {:else}
225
+ <div class="sv-ddl__empty">{M.noResults}</div>
226
+ {/if}
227
+ {#if footer}<div class="sv-ddl__footer">{@render footer()}</div>{/if}
228
+ {#if showGrip}
229
+ <!-- svelte-ignore a11y_no_static_element_interactions -->
230
+ <div class="sv-ddl__grip" onpointerdown={startResize} title="Drag to resize" aria-hidden="true">
231
+ <span class="sv-ddl__grip-dots"></span>
232
+ </div>
233
+ {/if}
234
+ </div>
235
+ {/if}
236
+ {#if name}<input type="hidden" {name} value={value ?? ''} />{/if}
237
+
238
+ <style>
239
+ .sv-combo {
240
+ --_accent: var(--sg-accent, #2563eb);
241
+ display: inline-flex; align-items: center; width: 200px;
242
+ background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a);
243
+ border: 1px solid var(--sg-input-border, var(--sg-border, #cbd5e1)); border-radius: var(--sg-radius, 8px);
244
+ }
245
+ .sv-combo--sm { height: 28px; font-size: 12px; }
246
+ .sv-combo--md { height: 34px; font-size: 13px; }
247
+ .sv-combo--lg { height: 40px; font-size: 15px; }
248
+ .sv-combo.is-open, .sv-combo:focus-within { border-color: var(--_accent); box-shadow: 0 0 0 2px color-mix(in srgb, var(--_accent) 22%, transparent); }
249
+ .sv-combo.is-invalid { border-color: var(--sg-danger, #dc2626); }
250
+ .sv-combo.is-invalid.is-open, .sv-combo.is-invalid:focus-within { box-shadow: 0 0 0 2px color-mix(in srgb, var(--sg-danger, #dc2626) 22%, transparent); }
251
+ .sv-combo.is-disabled { opacity: 0.6; }
252
+ .sv-combo__input { flex: 1; min-width: 0; border: 0; background: none; outline: none; color: inherit; font: inherit; padding-block: 0; padding-inline: 10px 4px; }
253
+ .sv-combo__clear { display: grid; place-items: center; width: 22px; align-self: center; flex: none; background: none; border: 0; color: var(--sg-muted, #64748b); cursor: pointer; border-radius: 4px; }
254
+ .sv-combo__clear:hover { color: var(--sg-danger, #dc2626); }
255
+ .sv-combo__chev { display: grid; place-items: center; width: 28px; align-self: stretch; background: none; border: 0; color: var(--sg-muted, #64748b); cursor: pointer; }
256
+ :global(.sv-ddl__empty) { padding: 8px 10px; color: var(--sg-muted, #94a3b8); font-size: 13px; }
257
+ :global(.sv-ddl__header) { padding: 8px 10px; border-bottom: 1px solid var(--sg-border, #e2e8f0); font-size: 12.5px; color: var(--sg-muted, #64748b); }
258
+ :global(.sv-ddl__footer) { padding: 8px 10px; border-top: 1px solid var(--sg-border, #e2e8f0); font-size: 12.5px; }
259
+ :global(.sv-ddl__loading) { display: flex; align-items: center; gap: 7px; }
260
+ :global(.sv-ddl__spin) { animation: sv-combo-spin 0.7s linear infinite; }
261
+ @keyframes sv-combo-spin { to { transform: rotate(360deg); } }
262
+ @media (prefers-reduced-motion: reduce) { :global(.sv-ddl__spin) { animation: none; } }
263
+ /* Bottom resize grip (shared "····" handle - see SvDropDownList / panel-resize). */
264
+ :global(.sv-ddl__panel.is-resizable) { padding-bottom: 0; }
265
+ :global(.sv-ddl__grip) {
266
+ position: sticky; bottom: 0; z-index: 1; margin: 2px -4px -4px; height: 15px;
267
+ display: flex; align-items: center; justify-content: center; cursor: ns-resize;
268
+ background: var(--sg-bg, #fff); border-top: 1px solid var(--sg-border, #e2e8f0);
269
+ border-radius: 0 0 10px 10px; touch-action: none;
270
+ }
271
+ :global(.sv-ddl__grip-dots) {
272
+ width: 26px; height: 4px; color: var(--sg-muted, #94a3b8); opacity: 0.6;
273
+ background-image: radial-gradient(currentColor 1px, transparent 1.6px);
274
+ background-size: 6px 4px; background-position: center; background-repeat: repeat-x;
275
+ }
276
+ :global(.sv-ddl__grip:hover .sv-ddl__grip-dots) { opacity: 1; }
277
+ /* Fill the container - see `block` in SvEditorProps. */
278
+ .sv-combo.is-block { width: 100%; max-width: 100%; }
279
+ </style>