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