@svgrid/grid 2.6.23 → 3.0.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 (263) 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/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 +744 -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-BzWXQjv3.js → GridMenus-DMihUtma.js} +3 -3
  56. package/dist/cdn/{GridMenus-xr_rHx8F.js → GridMenus-nmNDj1a3.js} +3 -3
  57. package/dist/cdn/{SvDateRangeInput-DMLKmGEc.js → SvDateRangeInput-Bh0A0JkF.js} +1 -1
  58. package/dist/cdn/{SvDateRangeInput-CaOuMs8O.js → SvDateRangeInput-DflbiP7N.js} +1 -1
  59. package/dist/cdn/{SvDateTimePicker-sonaH0oh.js → SvDateTimePicker-BWwpfB_o.js} +1 -1
  60. package/dist/cdn/{SvDateTimePicker-CCbDZNZB.js → SvDateTimePicker-Bivn8dAP.js} +1 -1
  61. package/dist/cdn/{SvGridCellEditor-BAPSC7EL.js → SvGridCellEditor-AXL8cHGO.js} +1 -1
  62. package/dist/cdn/{SvGridCellEditor-BwzmUWtL.js → SvGridCellEditor-Ba7rY3eu.js} +1 -1
  63. package/dist/cdn/{SvGridChart-BwVos976.js → SvGridChart-Bs2GIR2Q.js} +1 -1
  64. package/dist/cdn/{SvGridChart-BEJmNNx9.js → SvGridChart-CwhFz7GV.js} +1 -1
  65. package/dist/cdn/{SvGridChartPanel-BOknOkrP.js → SvGridChartPanel-1WXuStzM.js} +1 -1
  66. package/dist/cdn/{SvGridChartPanel-D2PjII4O.js → SvGridChartPanel-e5_nqNP9.js} +1 -1
  67. package/dist/cdn/{SvGridChartView-00LPUHL1.js → SvGridChartView-SmPW10dI.js} +1 -1
  68. package/dist/cdn/{SvGridChartView-BhUEJ5ki.js → SvGridChartView-eSPuJE6g.js} +1 -1
  69. package/dist/cdn/{SvGridDropdown-D0VdjeR8.js → SvGridDropdown-B1ZcLpgs.js} +1 -1
  70. package/dist/cdn/{SvGridDropdown-D13MtJ2j.js → SvGridDropdown-CtdbHcIS.js} +1 -1
  71. package/dist/cdn/{date-format-BnnHlqGw.js → date-format-CcP1tafP.js} +2 -2
  72. package/dist/cdn/{date-format-BNii4zeD.js → date-format-DZT7T1wf.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-skQN5eqh.js → src-B_YS5AOc.js} +45 -45
  75. package/dist/cdn/{src-DGo7IHug.js → src-DYXXpuSk.js} +44 -44
  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/row-drag-touch.d.ts +5 -1
  80. package/dist/row-drag-touch.js +15 -4
  81. package/dist/row-drag.js +7 -3
  82. package/package.json +11 -11
  83. package/src/FlexRender.svelte +96 -96
  84. package/src/GridFooter.svelte +181 -181
  85. package/src/SvAutoComplete.svelte +169 -169
  86. package/src/SvAvatar.svelte +75 -75
  87. package/src/SvCalendar.svelte +503 -503
  88. package/src/SvCalendar.test.ts +226 -226
  89. package/src/SvCarousel.svelte +141 -141
  90. package/src/SvCheckBox.svelte +102 -102
  91. package/src/SvCircularProgress.svelte +109 -109
  92. package/src/SvColorInput.svelte +181 -181
  93. package/src/SvComboBox.svelte +279 -279
  94. package/src/SvContextMenu.svelte +116 -116
  95. package/src/SvCountryInput.svelte +163 -163
  96. package/src/SvDrawer.svelte +254 -254
  97. package/src/SvDropDownList.svelte +378 -378
  98. package/src/SvDurationInput.svelte +126 -126
  99. package/src/SvField.svelte +293 -293
  100. package/src/SvForm.svelte +437 -437
  101. package/src/SvForm.test.ts +411 -411
  102. package/src/SvGrid.types.ts +2092 -2092
  103. package/src/SvGridCellEditor.svelte +744 -744
  104. package/src/SvGridChart.svelte +1716 -1716
  105. package/src/SvGridChartPanel.svelte +485 -485
  106. package/src/SvGridChartView.svelte +70 -70
  107. package/src/SvGridDropdown.svelte +728 -728
  108. package/src/SvGridSelect.svelte +270 -270
  109. package/src/SvGroupCell.svelte +116 -116
  110. package/src/SvListBox.svelte +334 -334
  111. package/src/SvMaskedInput.svelte +122 -122
  112. package/src/SvMenu.svelte +124 -124
  113. package/src/SvMenu.test.ts +97 -97
  114. package/src/SvMenuList.svelte +146 -146
  115. package/src/SvMultiSelect.svelte +293 -293
  116. package/src/SvNumberInput.svelte +172 -172
  117. package/src/SvOtpInput.svelte +158 -158
  118. package/src/SvPasswordInput.svelte +151 -151
  119. package/src/SvPhoneInput.svelte +133 -133
  120. package/src/SvPopover.svelte +197 -197
  121. package/src/SvProgress.svelte +116 -116
  122. package/src/SvRadioGroup.svelte +107 -107
  123. package/src/SvRating.svelte +112 -112
  124. package/src/SvResult.svelte +73 -73
  125. package/src/SvRichText.svelte +211 -211
  126. package/src/SvRowGroupPanel.svelte +170 -170
  127. package/src/SvScrollArea.svelte +61 -61
  128. package/src/SvSlider.svelte +203 -203
  129. package/src/SvSwitchButton.svelte +108 -108
  130. package/src/SvTagsInput.svelte +115 -115
  131. package/src/SvTextInput.svelte +147 -147
  132. package/src/SvTimePicker.svelte +245 -245
  133. package/src/SvToaster.svelte +159 -159
  134. package/src/SvToaster.test.ts +95 -95
  135. package/src/SvToggleButton.svelte +85 -85
  136. package/src/SvTooltip.svelte +161 -161
  137. package/src/SvTour.svelte +208 -208
  138. package/src/SvTree.svelte +444 -444
  139. package/src/SvTreeSelect.svelte +239 -239
  140. package/src/a11y/dismissable.test.ts +119 -119
  141. package/src/a11y/dismissable.ts +114 -114
  142. package/src/a11y.contract.test.ts +49 -49
  143. package/src/a11y.test.ts +59 -59
  144. package/src/a11y.ts +61 -61
  145. package/src/ai.test.ts +502 -502
  146. package/src/ai.ts +1419 -1419
  147. package/src/build-api.coverage.test.ts +633 -633
  148. package/src/build-api.ts +846 -846
  149. package/src/builtin-editors.grid.test.ts +83 -83
  150. package/src/cell-formatting.ts +171 -171
  151. package/src/cell-render.test.ts +513 -513
  152. package/src/cell-render.ts +496 -496
  153. package/src/cell-values.ts +148 -148
  154. package/src/chart-export.ts +202 -202
  155. package/src/chart-view.svelte.ts +36 -36
  156. package/src/chart.ts +2321 -2321
  157. package/src/collaboration.test.ts +104 -104
  158. package/src/collaboration.ts +167 -167
  159. package/src/column-groups.ts +78 -78
  160. package/src/core.performance.test.ts +30 -30
  161. package/src/core.ts +1865 -1865
  162. package/src/createAutocomplete.svelte.ts +132 -132
  163. package/src/createCombobox.svelte.ts +191 -191
  164. package/src/createCountryInput.svelte.ts +157 -157
  165. package/src/createDropdownList.svelte.ts +168 -168
  166. package/src/createForm.svelte.ts +386 -386
  167. package/src/createGrid.svelte.ts +42 -42
  168. package/src/createGrid.test.ts +10 -10
  169. package/src/createGridState.svelte.ts +17 -17
  170. package/src/createListbox.svelte.ts +250 -250
  171. package/src/createMenu.svelte.ts +224 -224
  172. package/src/createPopoverSelect.svelte.ts +213 -213
  173. package/src/createSlider.svelte.ts +191 -191
  174. package/src/createTooltip.svelte.ts +144 -144
  175. package/src/createTree.svelte.ts +322 -322
  176. package/src/datetime/date-core.ts +206 -206
  177. package/src/datetime/date-restrict.ts +61 -61
  178. package/src/datetime/timezone.ts +135 -135
  179. package/src/dock-manager-model.ts +596 -596
  180. package/src/dock-model.ts +374 -374
  181. package/src/editing.test.ts +974 -974
  182. package/src/editing.ts +609 -609
  183. package/src/editor-contract.ts +171 -171
  184. package/src/editor-registry.grid.test.ts +144 -144
  185. package/src/editor-registry.ts +122 -122
  186. package/src/export-data-api.test.ts +126 -126
  187. package/src/export-format.test.ts +107 -107
  188. package/src/export-format.ts +601 -601
  189. package/src/filter-operators.ts +160 -160
  190. package/src/filtering/excel-filters.ts +325 -325
  191. package/src/flex-render.ts +3 -3
  192. package/src/form-field.ts +127 -127
  193. package/src/group-display.test.ts +167 -167
  194. package/src/group-display.ts +200 -200
  195. package/src/headless.ts +87 -87
  196. package/src/js-scroller.svelte.ts +173 -173
  197. package/src/keyboard-handlers.ts +270 -270
  198. package/src/keyboard.test.ts +59 -59
  199. package/src/keyboard.ts +97 -97
  200. package/src/list-nav.test.ts +49 -49
  201. package/src/list-nav.ts +29 -29
  202. package/src/list-option.test.ts +56 -56
  203. package/src/list-option.ts +179 -179
  204. package/src/menus.ts +597 -597
  205. package/src/merge-objects.ts +48 -48
  206. package/src/overlays.test.ts +90 -90
  207. package/src/positioning.ts +268 -268
  208. package/src/render-component.ts +28 -28
  209. package/src/row-drag-touch.ts +20 -5
  210. package/src/row-drag.test.ts +401 -353
  211. package/src/row-drag.ts +419 -415
  212. package/src/row-resize.test.ts +524 -524
  213. package/src/row-resize.ts +228 -228
  214. package/src/scheduler-ical.ts +181 -181
  215. package/src/scheduler-model.test.ts +562 -562
  216. package/src/scheduler-model.ts +873 -873
  217. package/src/selection.test.ts +885 -885
  218. package/src/server-data-source.test.ts +383 -383
  219. package/src/server-data-source.ts +469 -469
  220. package/src/sparkline.test.ts +68 -68
  221. package/src/sparkline.ts +169 -169
  222. package/src/spreadsheet.test.ts +488 -488
  223. package/src/spreadsheet.ts +312 -312
  224. package/src/static-functions.ts +11 -11
  225. package/src/subscribe.ts +38 -38
  226. package/src/summaries.ts +113 -113
  227. package/src/svgrid-wrapper.types.ts +563 -563
  228. package/src/svgrid.async-editor-options.test.ts +273 -273
  229. package/src/svgrid.auto-row-height.test.ts +204 -204
  230. package/src/svgrid.behavior.test.ts +910 -910
  231. package/src/svgrid.charting.test.ts +534 -534
  232. package/src/svgrid.comments-autocomplete.test.ts +127 -127
  233. package/src/svgrid.context-menu.test.ts +147 -147
  234. package/src/svgrid.features.test.ts +157 -157
  235. package/src/svgrid.filter-depth.test.ts +163 -163
  236. package/src/svgrid.filter-menu-listbox.svelte.test.ts +377 -377
  237. package/src/svgrid.filter-menu-scroll.test.ts +112 -112
  238. package/src/svgrid.grand-total.test.ts +188 -188
  239. package/src/svgrid.group-display-mode.test.ts +171 -171
  240. package/src/svgrid.group-footers.test.ts +121 -121
  241. package/src/svgrid.group-pagination.test.ts +153 -153
  242. package/src/svgrid.new-features.wrapper.test.ts +251 -251
  243. package/src/svgrid.tree-data.test.ts +186 -186
  244. package/src/svgrid.wrapper.test.ts +63 -63
  245. package/src/svgriddropdown.async-panel.svelte.test.ts +195 -195
  246. package/src/test-setup.ts +62 -62
  247. package/src/themes/index.ts +288 -288
  248. package/src/toast-store.svelte.ts +250 -250
  249. package/src/toast-store.test.ts +147 -147
  250. package/src/tree-row-model.test.ts +168 -168
  251. package/src/ui-buttons.test.ts +144 -144
  252. package/src/ui-inputs.test.ts +118 -118
  253. package/src/ui-localization.test.ts +113 -113
  254. package/src/ui-range.test.ts +70 -70
  255. package/src/ui-selection.test.ts +155 -155
  256. package/src/ui-tier1.test.ts +142 -142
  257. package/src/virtual.test.ts +88 -88
  258. package/src/virtualization/column-virtualizer.test.ts +27 -27
  259. package/src/virtualization/column-virtualizer.ts +30 -30
  260. package/src/virtualization/svelte-virtualizer.svelte.ts +26 -26
  261. package/src/virtualization/types.ts +30 -30
  262. package/src/virtualization/virtualizer.test.ts +47 -47
  263. 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>