@svgrid/grid 2.6.17 → 2.6.18

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 (253) hide show
  1. package/CHANGELOG.md +346 -346
  2. package/README.md +199 -199
  3. package/dist/FlexRender.svelte +96 -96
  4. package/dist/GridFooter.svelte +181 -181
  5. package/dist/GridMenus.svelte +705 -705
  6. package/dist/SvAutoComplete.svelte +165 -165
  7. package/dist/SvAvatar.svelte +75 -75
  8. package/dist/SvCalendar.svelte +503 -503
  9. package/dist/SvCarousel.svelte +141 -141
  10. package/dist/SvCheckBox.svelte +102 -102
  11. package/dist/SvCircularProgress.svelte +109 -109
  12. package/dist/SvColorInput.svelte +181 -181
  13. package/dist/SvComboBox.svelte +275 -275
  14. package/dist/SvContextMenu.svelte +116 -116
  15. package/dist/SvCountryInput.svelte +163 -163
  16. package/dist/SvDrawer.svelte +254 -254
  17. package/dist/SvDropDownList.svelte +374 -374
  18. package/dist/SvDurationInput.svelte +126 -126
  19. package/dist/SvField.svelte +293 -293
  20. package/dist/SvForm.svelte +437 -437
  21. package/dist/SvGrid.css +2896 -2896
  22. package/dist/SvGrid.svelte +2956 -2956
  23. package/dist/SvGridCellEditor.svelte +662 -662
  24. package/dist/SvGridChart.svelte +1716 -1716
  25. package/dist/SvGridChartPanel.svelte +485 -485
  26. package/dist/SvGridChartView.svelte +70 -70
  27. package/dist/SvGridDropdown.svelte +728 -728
  28. package/dist/SvGridSelect.svelte +266 -266
  29. package/dist/SvGroupCell.svelte +116 -116
  30. package/dist/SvListBox.svelte +326 -326
  31. package/dist/SvMaskedInput.svelte +122 -122
  32. package/dist/SvMenu.svelte +124 -124
  33. package/dist/SvMenuList.svelte +146 -146
  34. package/dist/SvMultiSelect.svelte +289 -289
  35. package/dist/SvNumberInput.svelte +168 -168
  36. package/dist/SvOtpInput.svelte +158 -158
  37. package/dist/SvPasswordInput.svelte +151 -151
  38. package/dist/SvPhoneInput.svelte +133 -133
  39. package/dist/SvPopover.svelte +197 -197
  40. package/dist/SvProgress.svelte +116 -116
  41. package/dist/SvRadioGroup.svelte +107 -107
  42. package/dist/SvRating.svelte +112 -112
  43. package/dist/SvResult.svelte +73 -73
  44. package/dist/SvRichText.svelte +211 -211
  45. package/dist/SvRowGroupPanel.svelte +170 -170
  46. package/dist/SvScrollArea.svelte +61 -61
  47. package/dist/SvSlider.svelte +203 -203
  48. package/dist/SvSwitchButton.svelte +108 -108
  49. package/dist/SvTagsInput.svelte +115 -115
  50. package/dist/SvTextInput.svelte +147 -147
  51. package/dist/SvTimePicker.svelte +245 -245
  52. package/dist/SvToaster.svelte +159 -159
  53. package/dist/SvToggleButton.svelte +85 -85
  54. package/dist/SvTooltip.svelte +161 -161
  55. package/dist/SvTour.svelte +208 -208
  56. package/dist/SvTree.svelte +444 -444
  57. package/dist/SvTreeSelect.svelte +235 -235
  58. package/dist/cdn/{GridMenus-3kKYmYOE.js → GridMenus-B0F9iBrG.js} +2 -2
  59. package/dist/cdn/{GridMenus-BcDiwQ9U.js → GridMenus-IHK_l7m6.js} +2 -2
  60. package/dist/cdn/{SvDateTimePicker-DSUhIta8.js → SvDateTimePicker-CHnUkWcH.js} +2 -2
  61. package/dist/cdn/{SvDateTimePicker-h9kPyszT.js → SvDateTimePicker-CRQH_U7E.js} +2 -2
  62. package/dist/cdn/{SvGridCellEditor-DkyQO6FV.js → SvGridCellEditor-BGUCzuPB.js} +1 -1
  63. package/dist/cdn/{SvGridCellEditor-JpJSRhDx.js → SvGridCellEditor-G8IMWIws.js} +1 -1
  64. package/dist/cdn/{SvGridChart-CwhFz7GV.js → SvGridChart-BEJmNNx9.js} +1 -1
  65. package/dist/cdn/{SvGridChart-Bs2GIR2Q.js → SvGridChart-BwVos976.js} +1 -1
  66. package/dist/cdn/{SvGridChartPanel-1WXuStzM.js → SvGridChartPanel-BOknOkrP.js} +1 -1
  67. package/dist/cdn/{SvGridChartPanel-e5_nqNP9.js → SvGridChartPanel-D2PjII4O.js} +1 -1
  68. package/dist/cdn/{SvGridChartView-SmPW10dI.js → SvGridChartView-00LPUHL1.js} +1 -1
  69. package/dist/cdn/{SvGridChartView-eSPuJE6g.js → SvGridChartView-BhUEJ5ki.js} +1 -1
  70. package/dist/cdn/{SvGridDropdown-B1ZcLpgs.js → SvGridDropdown-D0VdjeR8.js} +1 -1
  71. package/dist/cdn/{SvGridDropdown-CtdbHcIS.js → SvGridDropdown-D13MtJ2j.js} +1 -1
  72. package/dist/cdn/{src-DMZZVVFd.js → src-B1TdiyS8.js} +26 -26
  73. package/dist/cdn/{src-D79V6bCA.js → src-Cd0tearp.js} +27 -27
  74. package/dist/cdn/svgrid.js +5 -5
  75. package/dist/cdn/svgrid.svelte-external.js +5 -5
  76. package/dist/chart-export.js +8 -8
  77. package/package.json +11 -11
  78. package/src/FlexRender.svelte +96 -96
  79. package/src/GridFooter.svelte +181 -181
  80. package/src/GridMenus.svelte +705 -705
  81. package/src/SvAutoComplete.svelte +165 -165
  82. package/src/SvAvatar.svelte +75 -75
  83. package/src/SvCalendar.svelte +503 -503
  84. package/src/SvCalendar.test.ts +226 -226
  85. package/src/SvCarousel.svelte +141 -141
  86. package/src/SvCheckBox.svelte +102 -102
  87. package/src/SvCircularProgress.svelte +109 -109
  88. package/src/SvColorInput.svelte +181 -181
  89. package/src/SvComboBox.svelte +275 -275
  90. package/src/SvContextMenu.svelte +116 -116
  91. package/src/SvCountryInput.svelte +163 -163
  92. package/src/SvDrawer.svelte +254 -254
  93. package/src/SvDropDownList.svelte +374 -374
  94. package/src/SvDurationInput.svelte +126 -126
  95. package/src/SvField.svelte +293 -293
  96. package/src/SvForm.svelte +437 -437
  97. package/src/SvForm.test.ts +411 -411
  98. package/src/SvGrid.controller.svelte.ts +3974 -3974
  99. package/src/SvGrid.css +2896 -2896
  100. package/src/SvGrid.svelte +2956 -2956
  101. package/src/SvGrid.types.ts +1790 -1790
  102. package/src/SvGridCellEditor.svelte +662 -662
  103. package/src/SvGridChart.svelte +1716 -1716
  104. package/src/SvGridChartPanel.svelte +485 -485
  105. package/src/SvGridChartView.svelte +70 -70
  106. package/src/SvGridDropdown.svelte +728 -728
  107. package/src/SvGridSelect.svelte +266 -266
  108. package/src/SvGroupCell.svelte +116 -116
  109. package/src/SvListBox.svelte +326 -326
  110. package/src/SvMaskedInput.svelte +122 -122
  111. package/src/SvMenu.svelte +124 -124
  112. package/src/SvMenu.test.ts +97 -97
  113. package/src/SvMenuList.svelte +146 -146
  114. package/src/SvMultiSelect.svelte +289 -289
  115. package/src/SvNumberInput.svelte +168 -168
  116. package/src/SvOtpInput.svelte +158 -158
  117. package/src/SvPasswordInput.svelte +151 -151
  118. package/src/SvPhoneInput.svelte +133 -133
  119. package/src/SvPopover.svelte +197 -197
  120. package/src/SvProgress.svelte +116 -116
  121. package/src/SvRadioGroup.svelte +107 -107
  122. package/src/SvRating.svelte +112 -112
  123. package/src/SvResult.svelte +73 -73
  124. package/src/SvRichText.svelte +211 -211
  125. package/src/SvRowGroupPanel.svelte +170 -170
  126. package/src/SvScrollArea.svelte +61 -61
  127. package/src/SvSlider.svelte +203 -203
  128. package/src/SvSwitchButton.svelte +108 -108
  129. package/src/SvTagsInput.svelte +115 -115
  130. package/src/SvTextInput.svelte +147 -147
  131. package/src/SvTimePicker.svelte +245 -245
  132. package/src/SvToaster.svelte +159 -159
  133. package/src/SvToaster.test.ts +95 -95
  134. package/src/SvToggleButton.svelte +85 -85
  135. package/src/SvTooltip.svelte +161 -161
  136. package/src/SvTour.svelte +208 -208
  137. package/src/SvTree.svelte +444 -444
  138. package/src/SvTreeSelect.svelte +235 -235
  139. package/src/a11y/dismissable.test.ts +119 -119
  140. package/src/a11y/dismissable.ts +114 -114
  141. package/src/a11y.contract.test.ts +49 -49
  142. package/src/a11y.test.ts +59 -59
  143. package/src/a11y.ts +61 -61
  144. package/src/ai.test.ts +502 -502
  145. package/src/ai.ts +1391 -1391
  146. package/src/build-api.coverage.test.ts +633 -633
  147. package/src/build-api.ts +846 -846
  148. package/src/builtin-editors.grid.test.ts +83 -83
  149. package/src/cell-formatting.ts +169 -169
  150. package/src/cell-render.test.ts +513 -513
  151. package/src/cell-render.ts +496 -496
  152. package/src/cell-values.ts +118 -118
  153. package/src/chart-export.ts +201 -201
  154. package/src/chart-view.svelte.ts +36 -36
  155. package/src/chart.ts +2295 -2295
  156. package/src/collaboration.test.ts +104 -104
  157. package/src/collaboration.ts +167 -167
  158. package/src/core.performance.test.ts +30 -30
  159. package/src/core.ts +1261 -1261
  160. package/src/createAutocomplete.svelte.ts +132 -132
  161. package/src/createCombobox.svelte.ts +191 -191
  162. package/src/createCountryInput.svelte.ts +157 -157
  163. package/src/createDropdownList.svelte.ts +168 -168
  164. package/src/createForm.svelte.ts +386 -386
  165. package/src/createGrid.svelte.ts +42 -42
  166. package/src/createGrid.test.ts +10 -10
  167. package/src/createGridState.svelte.ts +17 -17
  168. package/src/createListbox.svelte.ts +250 -250
  169. package/src/createMenu.svelte.ts +224 -224
  170. package/src/createPopoverSelect.svelte.ts +213 -213
  171. package/src/createSlider.svelte.ts +191 -191
  172. package/src/createTooltip.svelte.ts +144 -144
  173. package/src/createTree.svelte.ts +319 -319
  174. package/src/editing.test.ts +949 -949
  175. package/src/editing.ts +606 -606
  176. package/src/editor-contract.ts +170 -170
  177. package/src/editor-registry.grid.test.ts +144 -144
  178. package/src/editor-registry.ts +122 -122
  179. package/src/export-data-api.test.ts +126 -126
  180. package/src/export-format.test.ts +107 -107
  181. package/src/export-format.ts +601 -601
  182. package/src/filter-operators.ts +160 -160
  183. package/src/flex-render.ts +3 -3
  184. package/src/form-field.ts +127 -127
  185. package/src/group-display.test.ts +167 -167
  186. package/src/group-display.ts +200 -200
  187. package/src/headless.ts +87 -87
  188. package/src/index.ts +754 -754
  189. package/src/js-scroller.svelte.ts +173 -173
  190. package/src/keyboard-handlers.ts +270 -270
  191. package/src/keyboard.test.ts +59 -59
  192. package/src/keyboard.ts +97 -97
  193. package/src/list-nav.test.ts +49 -49
  194. package/src/list-nav.ts +29 -29
  195. package/src/list-option.test.ts +56 -56
  196. package/src/list-option.ts +172 -172
  197. package/src/menus.ts +567 -567
  198. package/src/merge-objects.ts +48 -48
  199. package/src/overlays.test.ts +90 -90
  200. package/src/render-component.ts +28 -28
  201. package/src/row-drag-touch.ts +211 -211
  202. package/src/row-drag.test.ts +353 -353
  203. package/src/row-drag.ts +415 -415
  204. package/src/row-resize.ts +210 -210
  205. package/src/scheduler-model.test.ts +562 -562
  206. package/src/scheduler-model.ts +872 -872
  207. package/src/selection.test.ts +754 -754
  208. package/src/selection.ts +491 -491
  209. package/src/server-data-source.test.ts +383 -383
  210. package/src/server-data-source.ts +469 -469
  211. package/src/sparkline.test.ts +68 -68
  212. package/src/sparkline.ts +169 -169
  213. package/src/spreadsheet.test.ts +488 -488
  214. package/src/spreadsheet.ts +312 -312
  215. package/src/static-functions.ts +11 -11
  216. package/src/subscribe.ts +38 -38
  217. package/src/svgrid-wrapper.types.ts +558 -558
  218. package/src/svgrid.async-editor-options.test.ts +273 -273
  219. package/src/svgrid.auto-row-height.test.ts +204 -204
  220. package/src/svgrid.behavior.test.ts +910 -910
  221. package/src/svgrid.charting.test.ts +534 -534
  222. package/src/svgrid.comments-autocomplete.test.ts +127 -127
  223. package/src/svgrid.context-menu.test.ts +147 -147
  224. package/src/svgrid.features.test.ts +157 -157
  225. package/src/svgrid.filter-depth.test.ts +163 -163
  226. package/src/svgrid.filter-menu-listbox.svelte.test.ts +331 -331
  227. package/src/svgrid.filter-menu-scroll.test.ts +112 -112
  228. package/src/svgrid.grand-total.test.ts +188 -188
  229. package/src/svgrid.group-display-mode.test.ts +171 -171
  230. package/src/svgrid.group-footers.test.ts +121 -121
  231. package/src/svgrid.group-pagination.test.ts +153 -153
  232. package/src/svgrid.new-features.wrapper.test.ts +251 -251
  233. package/src/svgrid.tree-data.test.ts +186 -186
  234. package/src/svgrid.wrapper.test.ts +63 -63
  235. package/src/svgriddropdown.async-panel.svelte.test.ts +195 -195
  236. package/src/test-setup.ts +62 -62
  237. package/src/themes/index.ts +288 -288
  238. package/src/toast-store.svelte.ts +246 -246
  239. package/src/toast-store.test.ts +147 -147
  240. package/src/tree-row-model.test.ts +168 -168
  241. package/src/ui-buttons.test.ts +144 -144
  242. package/src/ui-inputs.test.ts +118 -118
  243. package/src/ui-localization.test.ts +113 -113
  244. package/src/ui-range.test.ts +70 -70
  245. package/src/ui-selection.test.ts +155 -155
  246. package/src/ui-tier1.test.ts +142 -142
  247. package/src/virtual.test.ts +88 -88
  248. package/src/virtualization/column-virtualizer.test.ts +27 -27
  249. package/src/virtualization/column-virtualizer.ts +30 -30
  250. package/src/virtualization/svelte-virtualizer.svelte.ts +26 -26
  251. package/src/virtualization/types.ts +30 -30
  252. package/src/virtualization/virtualizer.test.ts +47 -47
  253. package/src/virtualization/virtualizer.ts +322 -322
@@ -1,289 +1,289 @@
1
- <script lang="ts" module>
2
- export type { MultiSelectOption } from './ui-app.types'
3
- </script>
4
-
5
- <script lang="ts">
6
- /**
7
- * SvMultiSelect - a multi-select dropdown: a trigger showing the picked items
8
- * as chips (collapsing to "+N"), and a portalled panel with an optional search
9
- * box and a checkbox list. The open/position/dismiss/roving/keyboard/ARIA
10
- * mechanics come from the shared `createPopoverSelect` core; this component adds
11
- * the multi-select toggle, chips and search UI. Distinct from SvTagsInput
12
- * (free-form tags) - this picks from a fixed set.
13
- */
14
- import type { MultiSelectOption } from './ui-app.types'
15
- import SvField from './SvField.svelte'
16
- import { editorAria, nextEditorId, type SvEditorProps } from './editor-contract'
17
- import { portalToBody, popIn } from './popover'
18
- import { createPopoverSelect } from './createPopoverSelect.svelte'
19
- import { debounce } from './debounce'
20
-
21
- type Props = Pick<
22
- SvEditorProps,
23
- 'disabled' | 'readonly' | 'label' | 'hint' | 'error' | 'required' | 'invalid' | 'size' | 'id' | 'name' | 'dir' | 'ariaLabel' | 'loading'
24
- > & {
25
- options: ReadonlyArray<MultiSelectOption>
26
- value?: ReadonlyArray<string | number>
27
- onChange?: (value: Array<string | number>) => void
28
- onCommit?: (value: Array<string | number>) => void
29
- onCancel?: () => void
30
- placeholder?: string
31
- searchable?: boolean
32
- maxTagCount?: number
33
- clearable?: boolean
34
- /** Async/remote options: called (debounced) with the search query; its
35
- * result replaces the list. When set, `options` is only the initial list. */
36
- loadOptions?: (query: string) => Promise<MultiSelectOption[]>
37
- /** Debounce for remote search. Default 250ms. */
38
- debounceMs?: number
39
- loadingText?: string
40
- /** Shown when the list is empty / a search matches nothing (localization). */
41
- emptyText?: string
42
- /** Placeholder in the panel's search box (localization). */
43
- searchPlaceholder?: string
44
- /** Accessible name for the panel's search box (localization). */
45
- searchLabel?: string
46
- }
47
-
48
- let {
49
- options,
50
- value = $bindable<ReadonlyArray<string | number>>([]),
51
- onChange,
52
- onCommit,
53
- placeholder = 'Select…',
54
- searchable = true,
55
- maxTagCount = 3,
56
- clearable = true,
57
- loadOptions,
58
- debounceMs = 250,
59
- loadingText = 'Loading…',
60
- emptyText = 'No matches',
61
- searchPlaceholder = 'Search…',
62
- searchLabel = 'Search options',
63
- disabled = false,
64
- readonly = false,
65
- label,
66
- hint,
67
- error,
68
- required = false,
69
- invalid = false,
70
- size = 'md',
71
- id,
72
- name,
73
- dir,
74
- ariaLabel,
75
- loading: loadingProp = false,
76
- }: Props = $props()
77
-
78
- const autoId = nextEditorId('sv-ms')
79
- const uid = $derived(id ?? autoId)
80
-
81
- let search = $state('')
82
- let triggerEl = $state<HTMLButtonElement | null>(null)
83
- let panelEl = $state<HTMLDivElement | null>(null)
84
- let searchEl = $state<HTMLInputElement | null>(null)
85
- let listEl = $state<HTMLUListElement | null>(null)
86
-
87
- // Remote/async options: `asyncOptions` holds the last server result; a stale
88
- // response is dropped by comparing the request sequence.
89
- let asyncOptions = $state<MultiSelectOption[]>([])
90
- let loading = $state(false)
91
- let reqSeq = 0
92
- function doLoad(q: string) {
93
- if (!loadOptions) return
94
- const seq = ++reqSeq
95
- loading = true
96
- loadOptions(q)
97
- .then((opts) => { if (seq === reqSeq) { asyncOptions = opts; loading = false } })
98
- .catch(() => { if (seq === reqSeq) loading = false })
99
- }
100
- const runLoad = debounce((q: string) => doLoad(q), debounceMs)
101
-
102
- const selected = $derived(new Set(value))
103
- const filtered = $derived(
104
- loadOptions
105
- ? asyncOptions
106
- : search.trim()
107
- ? options.filter((o) => o.label.toLowerCase().includes(search.trim().toLowerCase()))
108
- : options,
109
- )
110
- // Pool for resolving selected-chip labels (a remote-selected value may not be
111
- // in the current result page, so merge the seed options with the last result).
112
- const pool = $derived(
113
- loadOptions
114
- ? [...new Map([...options, ...asyncOptions].map((o) => [o.value, o])).values()]
115
- : options,
116
- )
117
- const selectedOptions = $derived(pool.filter((o) => selected.has(o.value)))
118
-
119
- function emit(next: Array<string | number>) {
120
- value = next // enables bind:value
121
- onChange?.(next)
122
- }
123
- function toggleOption(opt: MultiSelectOption) {
124
- if (opt.disabled) return
125
- const next = new Set(selected)
126
- next.has(opt.value) ? next.delete(opt.value) : next.add(opt.value)
127
- emit([...next])
128
- }
129
-
130
- const ms = createPopoverSelect({
131
- itemCount: () => filtered.length,
132
- disabled: (i) => !!filtered[i]?.disabled,
133
- readonly: () => readonly,
134
- onSelect: (i) => { const o = filtered[i]; if (o) toggleOption(o) },
135
- onOpenChange: (o) => { if (o) { search = ''; if (loadOptions) doLoad('') } },
136
- getTrigger: () => triggerEl,
137
- getPanel: () => panelEl,
138
- getInitialFocus: () => (searchable ? searchEl : listEl),
139
- closeOnSelect: () => false,
140
- minWidth: () => 200,
141
- idPrefix: 'sv-ms',
142
- })
143
- </script>
144
-
145
- <SvField id={uid} {label} {hint} {error} {required} {dir} loading={loadingProp || loading}>
146
- <div class="sv-ms sv-ms--{size}" class:is-disabled={disabled}>
147
- <button
148
- bind:this={triggerEl}
149
- type="button"
150
- class="sv-ms__trigger"
151
- class:is-invalid={invalid}
152
- {disabled}
153
- onclick={() => ms.toggle()}
154
- {...ms.triggerProps()}
155
- {...editorAria({ id: uid, invalid, required, error, hint, ariaLabel })}
156
- >
157
- {#if selectedOptions.length === 0}
158
- <span class="sv-ms__placeholder">{placeholder}</span>
159
- {:else}
160
- <span class="sv-ms__chips">
161
- {#each selectedOptions.slice(0, maxTagCount) as opt, i (i)}
162
- <span class="sv-ms__chip">{opt.label}</span>
163
- {/each}
164
- {#if selectedOptions.length > maxTagCount}
165
- <span class="sv-ms__chip sv-ms__chip--more">+{selectedOptions.length - maxTagCount}</span>
166
- {/if}
167
- </span>
168
- {/if}
169
- <span class="sv-ms__arrow" aria-hidden="true">▾</span>
170
- </button>
171
- {#if clearable && selectedOptions.length && !disabled}
172
- <button type="button" class="sv-ms__clear" tabindex="-1" aria-label="Clear all" onclick={() => emit([])}>&times;</button>
173
- {/if}
174
- {#if name}
175
- {#each value as v (v)}<input type="hidden" {name} value={v} />{/each}
176
- {/if}
177
- </div>
178
- </SvField>
179
-
180
- {#if ms.open}
181
- <!-- svelte-ignore a11y_no_static_element_interactions -->
182
- <div
183
- bind:this={panelEl}
184
- class="sv-ms__panel"
185
- dir={dir}
186
- use:portalToBody
187
- use:popIn={{ up: ms.rect.openUpward }}
188
- style:position="fixed"
189
- style:top={`${ms.rect.top}px`}
190
- style:left={`${ms.rect.left}px`}
191
- style:min-width={`${ms.rect.width}px`}
192
- style:max-height={`${ms.rect.maxHeight}px`}
193
- onkeydown={ms.onPanelKeydown}
194
- >
195
- {#if searchable}
196
- <!-- svelte-ignore a11y_autofocus -->
197
- <input
198
- bind:this={searchEl}
199
- class="sv-ms__search"
200
- role="combobox"
201
- aria-expanded="true"
202
- aria-controls={ms.panelId}
203
- aria-activedescendant={ms.activeDescendant()}
204
- aria-label={searchLabel}
205
- placeholder={searchPlaceholder}
206
- value={search}
207
- oninput={(e) => { search = e.currentTarget.value; ms.active = 0; if (loadOptions) runLoad(search) }}
208
- />
209
- {/if}
210
- <ul
211
- bind:this={listEl}
212
- id={ms.panelId}
213
- class="sv-ms__list"
214
- role="listbox"
215
- aria-multiselectable="true"
216
- aria-label={label ?? ariaLabel ?? 'Options'}
217
- aria-activedescendant={searchable ? undefined : ms.activeDescendant()}
218
- tabindex={searchable ? -1 : 0}
219
- >
220
- {#each filtered as opt, i (i)}
221
- <li
222
- class="sv-ms__opt"
223
- class:is-active={ms.isActive(i)}
224
- class:is-disabled={opt.disabled}
225
- role="option"
226
- aria-selected={selected.has(opt.value)}
227
- aria-disabled={opt.disabled}
228
- onclick={() => toggleOption(opt)}
229
- {...ms.itemProps(i)}
230
- >
231
- <span class="sv-ms__check" aria-hidden="true">{selected.has(opt.value) ? '✓' : ''}</span>
232
- <span class="sv-ms__label">{opt.label}</span>
233
- </li>
234
- {:else}
235
- <li class="sv-ms__empty" aria-disabled="true">{loading ? loadingText : emptyText}</li>
236
- {/each}
237
- {#if loading && filtered.length}
238
- <li class="sv-ms__loading" aria-live="polite">{loadingText}</li>
239
- {/if}
240
- </ul>
241
- <div class="sv-ms__footer">
242
- <button type="button" class="sv-ms__done" onclick={() => { onCommit?.([...value]); ms.closePanel() }}>Done</button>
243
- </div>
244
- </div>
245
- {/if}
246
-
247
- <style>
248
- .sv-ms { --_accent: var(--sg-accent, #2563eb); display: inline-flex; align-items: stretch; position: relative; width: 240px; }
249
- .sv-ms.is-disabled { opacity: 0.6; }
250
- .sv-ms__trigger {
251
- flex: 1; min-width: 0; display: flex; align-items: center; gap: 6px; text-align: start;
252
- background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a);
253
- border: 1px solid var(--sg-input-border, var(--sg-border, #cbd5e1)); border-radius: var(--sg-radius, 8px);
254
- font: inherit; cursor: pointer; padding: 0 8px;
255
- }
256
- .sv-ms--sm .sv-ms__trigger { min-height: 28px; font-size: 12px; }
257
- .sv-ms--md .sv-ms__trigger { min-height: 34px; font-size: 13px; }
258
- .sv-ms--lg .sv-ms__trigger { min-height: 40px; font-size: 15px; }
259
- .sv-ms__trigger:focus-visible { outline: none; border-color: var(--_accent); box-shadow: 0 0 0 2px color-mix(in srgb, var(--_accent) 22%, transparent); }
260
- .sv-ms__trigger.is-invalid { border-color: var(--sg-danger, #dc2626); }
261
- .sv-ms__placeholder { flex: 1; color: var(--sg-muted, #94a3b8); }
262
- .sv-ms__chips { flex: 1; display: flex; flex-wrap: wrap; gap: 4px; padding: 4px 0; }
263
- .sv-ms__chip { display: inline-flex; align-items: center; padding: 1px 7px; border-radius: 999px; font-size: 11.5px; background: color-mix(in srgb, var(--_accent) 14%, transparent); color: var(--_accent); }
264
- .sv-ms__chip--more { background: var(--sg-row-hover-bg, #f1f5f9); color: var(--sg-muted, #64748b); }
265
- .sv-ms__arrow { margin-inline-start: auto; color: var(--sg-muted, #64748b); font-size: 10px; }
266
- .sv-ms__clear { position: absolute; inset-inline-end: 26px; align-self: center; background: none; border: 0; color: var(--sg-muted, #64748b); cursor: pointer; font-size: 15px; }
267
- .sv-ms__clear:hover { color: var(--sg-fg, #0f172a); }
268
-
269
- :global(.sv-ms__panel) {
270
- z-index: 2147483646; display: flex; flex-direction: column; max-height: 300px; max-width: 92vw;
271
- background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a);
272
- border: 1px solid var(--sg-border, #e2e8f0); border-radius: 10px; overflow: hidden;
273
- box-shadow: 0 16px 48px -12px rgba(15, 23, 42, 0.35); font-size: 13px;
274
- }
275
- :global(.sv-ms__search) {
276
- margin: 8px; padding: 6px 9px; font: inherit; font-size: 13px;
277
- border: 1px solid var(--sg-input-border, #cbd5e1); border-radius: 7px;
278
- background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a); outline: none;
279
- }
280
- :global(.sv-ms__list) { list-style: none; margin: 0; padding: 4px; overflow: auto; flex: 1; outline: none; }
281
- :global(.sv-ms__opt) { display: flex; align-items: center; gap: 8px; padding: 6px 8px; border-radius: 6px; cursor: pointer; }
282
- :global(.sv-ms__opt.is-active) { background: var(--sg-row-hover-bg, #f1f5f9); }
283
- :global(.sv-ms__opt.is-disabled) { opacity: 0.5; cursor: not-allowed; }
284
- :global(.sv-ms__check) { width: 14px; color: var(--sg-accent, #2563eb); font-weight: 700; }
285
- :global(.sv-ms__empty) { padding: 10px; color: var(--sg-muted, #94a3b8); text-align: center; }
286
- :global(.sv-ms__loading) { padding: 8px 10px; color: var(--sg-muted, #94a3b8); font-size: 12px; text-align: center; }
287
- :global(.sv-ms__footer) { display: flex; justify-content: flex-end; padding: 6px 8px; border-top: 1px solid var(--sg-border, #e2e8f0); }
288
- :global(.sv-ms__done) { font: inherit; font-size: 12.5px; padding: 4px 12px; border: 0; border-radius: 6px; background: var(--sg-accent, #2563eb); color: var(--sg-on-accent, #fff); cursor: pointer; }
289
- </style>
1
+ <script lang="ts" module>
2
+ export type { MultiSelectOption } from './ui-app.types'
3
+ </script>
4
+
5
+ <script lang="ts">
6
+ /**
7
+ * SvMultiSelect - a multi-select dropdown: a trigger showing the picked items
8
+ * as chips (collapsing to "+N"), and a portalled panel with an optional search
9
+ * box and a checkbox list. The open/position/dismiss/roving/keyboard/ARIA
10
+ * mechanics come from the shared `createPopoverSelect` core; this component adds
11
+ * the multi-select toggle, chips and search UI. Distinct from SvTagsInput
12
+ * (free-form tags) - this picks from a fixed set.
13
+ */
14
+ import type { MultiSelectOption } from './ui-app.types'
15
+ import SvField from './SvField.svelte'
16
+ import { editorAria, nextEditorId, type SvEditorProps } from './editor-contract'
17
+ import { portalToBody, popIn } from './popover'
18
+ import { createPopoverSelect } from './createPopoverSelect.svelte'
19
+ import { debounce } from './debounce'
20
+
21
+ type Props = Pick<
22
+ SvEditorProps,
23
+ 'disabled' | 'readonly' | 'label' | 'hint' | 'error' | 'required' | 'invalid' | 'size' | 'id' | 'name' | 'dir' | 'ariaLabel' | 'loading'
24
+ > & {
25
+ options: ReadonlyArray<MultiSelectOption>
26
+ value?: ReadonlyArray<string | number>
27
+ onChange?: (value: Array<string | number>) => void
28
+ onCommit?: (value: Array<string | number>) => void
29
+ onCancel?: () => void
30
+ placeholder?: string
31
+ searchable?: boolean
32
+ maxTagCount?: number
33
+ clearable?: boolean
34
+ /** Async/remote options: called (debounced) with the search query; its
35
+ * result replaces the list. When set, `options` is only the initial list. */
36
+ loadOptions?: (query: string) => Promise<MultiSelectOption[]>
37
+ /** Debounce for remote search. Default 250ms. */
38
+ debounceMs?: number
39
+ loadingText?: string
40
+ /** Shown when the list is empty / a search matches nothing (localization). */
41
+ emptyText?: string
42
+ /** Placeholder in the panel's search box (localization). */
43
+ searchPlaceholder?: string
44
+ /** Accessible name for the panel's search box (localization). */
45
+ searchLabel?: string
46
+ }
47
+
48
+ let {
49
+ options,
50
+ value = $bindable<ReadonlyArray<string | number>>([]),
51
+ onChange,
52
+ onCommit,
53
+ placeholder = 'Select…',
54
+ searchable = true,
55
+ maxTagCount = 3,
56
+ clearable = true,
57
+ loadOptions,
58
+ debounceMs = 250,
59
+ loadingText = 'Loading…',
60
+ emptyText = 'No matches',
61
+ searchPlaceholder = 'Search…',
62
+ searchLabel = 'Search options',
63
+ disabled = false,
64
+ readonly = false,
65
+ label,
66
+ hint,
67
+ error,
68
+ required = false,
69
+ invalid = false,
70
+ size = 'md',
71
+ id,
72
+ name,
73
+ dir,
74
+ ariaLabel,
75
+ loading: loadingProp = false,
76
+ }: Props = $props()
77
+
78
+ const autoId = nextEditorId('sv-ms')
79
+ const uid = $derived(id ?? autoId)
80
+
81
+ let search = $state('')
82
+ let triggerEl = $state<HTMLButtonElement | null>(null)
83
+ let panelEl = $state<HTMLDivElement | null>(null)
84
+ let searchEl = $state<HTMLInputElement | null>(null)
85
+ let listEl = $state<HTMLUListElement | null>(null)
86
+
87
+ // Remote/async options: `asyncOptions` holds the last server result; a stale
88
+ // response is dropped by comparing the request sequence.
89
+ let asyncOptions = $state<MultiSelectOption[]>([])
90
+ let loading = $state(false)
91
+ let reqSeq = 0
92
+ function doLoad(q: string) {
93
+ if (!loadOptions) return
94
+ const seq = ++reqSeq
95
+ loading = true
96
+ loadOptions(q)
97
+ .then((opts) => { if (seq === reqSeq) { asyncOptions = opts; loading = false } })
98
+ .catch(() => { if (seq === reqSeq) loading = false })
99
+ }
100
+ const runLoad = debounce((q: string) => doLoad(q), debounceMs)
101
+
102
+ const selected = $derived(new Set(value))
103
+ const filtered = $derived(
104
+ loadOptions
105
+ ? asyncOptions
106
+ : search.trim()
107
+ ? options.filter((o) => o.label.toLowerCase().includes(search.trim().toLowerCase()))
108
+ : options,
109
+ )
110
+ // Pool for resolving selected-chip labels (a remote-selected value may not be
111
+ // in the current result page, so merge the seed options with the last result).
112
+ const pool = $derived(
113
+ loadOptions
114
+ ? [...new Map([...options, ...asyncOptions].map((o) => [o.value, o])).values()]
115
+ : options,
116
+ )
117
+ const selectedOptions = $derived(pool.filter((o) => selected.has(o.value)))
118
+
119
+ function emit(next: Array<string | number>) {
120
+ value = next // enables bind:value
121
+ onChange?.(next)
122
+ }
123
+ function toggleOption(opt: MultiSelectOption) {
124
+ if (opt.disabled) return
125
+ const next = new Set(selected)
126
+ next.has(opt.value) ? next.delete(opt.value) : next.add(opt.value)
127
+ emit([...next])
128
+ }
129
+
130
+ const ms = createPopoverSelect({
131
+ itemCount: () => filtered.length,
132
+ disabled: (i) => !!filtered[i]?.disabled,
133
+ readonly: () => readonly,
134
+ onSelect: (i) => { const o = filtered[i]; if (o) toggleOption(o) },
135
+ onOpenChange: (o) => { if (o) { search = ''; if (loadOptions) doLoad('') } },
136
+ getTrigger: () => triggerEl,
137
+ getPanel: () => panelEl,
138
+ getInitialFocus: () => (searchable ? searchEl : listEl),
139
+ closeOnSelect: () => false,
140
+ minWidth: () => 200,
141
+ idPrefix: 'sv-ms',
142
+ })
143
+ </script>
144
+
145
+ <SvField id={uid} {label} {hint} {error} {required} {dir} loading={loadingProp || loading}>
146
+ <div class="sv-ms sv-ms--{size}" class:is-disabled={disabled}>
147
+ <button
148
+ bind:this={triggerEl}
149
+ type="button"
150
+ class="sv-ms__trigger"
151
+ class:is-invalid={invalid}
152
+ {disabled}
153
+ onclick={() => ms.toggle()}
154
+ {...ms.triggerProps()}
155
+ {...editorAria({ id: uid, invalid, required, error, hint, ariaLabel })}
156
+ >
157
+ {#if selectedOptions.length === 0}
158
+ <span class="sv-ms__placeholder">{placeholder}</span>
159
+ {:else}
160
+ <span class="sv-ms__chips">
161
+ {#each selectedOptions.slice(0, maxTagCount) as opt, i (i)}
162
+ <span class="sv-ms__chip">{opt.label}</span>
163
+ {/each}
164
+ {#if selectedOptions.length > maxTagCount}
165
+ <span class="sv-ms__chip sv-ms__chip--more">+{selectedOptions.length - maxTagCount}</span>
166
+ {/if}
167
+ </span>
168
+ {/if}
169
+ <span class="sv-ms__arrow" aria-hidden="true">▾</span>
170
+ </button>
171
+ {#if clearable && selectedOptions.length && !disabled}
172
+ <button type="button" class="sv-ms__clear" tabindex="-1" aria-label="Clear all" onclick={() => emit([])}>&times;</button>
173
+ {/if}
174
+ {#if name}
175
+ {#each value as v (v)}<input type="hidden" {name} value={v} />{/each}
176
+ {/if}
177
+ </div>
178
+ </SvField>
179
+
180
+ {#if ms.open}
181
+ <!-- svelte-ignore a11y_no_static_element_interactions -->
182
+ <div
183
+ bind:this={panelEl}
184
+ class="sv-ms__panel"
185
+ dir={dir}
186
+ use:portalToBody
187
+ use:popIn={{ up: ms.rect.openUpward }}
188
+ style:position="fixed"
189
+ style:top={`${ms.rect.top}px`}
190
+ style:left={`${ms.rect.left}px`}
191
+ style:min-width={`${ms.rect.width}px`}
192
+ style:max-height={`${ms.rect.maxHeight}px`}
193
+ onkeydown={ms.onPanelKeydown}
194
+ >
195
+ {#if searchable}
196
+ <!-- svelte-ignore a11y_autofocus -->
197
+ <input
198
+ bind:this={searchEl}
199
+ class="sv-ms__search"
200
+ role="combobox"
201
+ aria-expanded="true"
202
+ aria-controls={ms.panelId}
203
+ aria-activedescendant={ms.activeDescendant()}
204
+ aria-label={searchLabel}
205
+ placeholder={searchPlaceholder}
206
+ value={search}
207
+ oninput={(e) => { search = e.currentTarget.value; ms.active = 0; if (loadOptions) runLoad(search) }}
208
+ />
209
+ {/if}
210
+ <ul
211
+ bind:this={listEl}
212
+ id={ms.panelId}
213
+ class="sv-ms__list"
214
+ role="listbox"
215
+ aria-multiselectable="true"
216
+ aria-label={label ?? ariaLabel ?? 'Options'}
217
+ aria-activedescendant={searchable ? undefined : ms.activeDescendant()}
218
+ tabindex={searchable ? -1 : 0}
219
+ >
220
+ {#each filtered as opt, i (i)}
221
+ <li
222
+ class="sv-ms__opt"
223
+ class:is-active={ms.isActive(i)}
224
+ class:is-disabled={opt.disabled}
225
+ role="option"
226
+ aria-selected={selected.has(opt.value)}
227
+ aria-disabled={opt.disabled}
228
+ onclick={() => toggleOption(opt)}
229
+ {...ms.itemProps(i)}
230
+ >
231
+ <span class="sv-ms__check" aria-hidden="true">{selected.has(opt.value) ? '✓' : ''}</span>
232
+ <span class="sv-ms__label">{opt.label}</span>
233
+ </li>
234
+ {:else}
235
+ <li class="sv-ms__empty" aria-disabled="true">{loading ? loadingText : emptyText}</li>
236
+ {/each}
237
+ {#if loading && filtered.length}
238
+ <li class="sv-ms__loading" aria-live="polite">{loadingText}</li>
239
+ {/if}
240
+ </ul>
241
+ <div class="sv-ms__footer">
242
+ <button type="button" class="sv-ms__done" onclick={() => { onCommit?.([...value]); ms.closePanel() }}>Done</button>
243
+ </div>
244
+ </div>
245
+ {/if}
246
+
247
+ <style>
248
+ .sv-ms { --_accent: var(--sg-accent, #2563eb); display: inline-flex; align-items: stretch; position: relative; width: 240px; }
249
+ .sv-ms.is-disabled { opacity: 0.6; }
250
+ .sv-ms__trigger {
251
+ flex: 1; min-width: 0; display: flex; align-items: center; gap: 6px; text-align: start;
252
+ background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a);
253
+ border: 1px solid var(--sg-input-border, var(--sg-border, #cbd5e1)); border-radius: var(--sg-radius, 8px);
254
+ font: inherit; cursor: pointer; padding: 0 8px;
255
+ }
256
+ .sv-ms--sm .sv-ms__trigger { min-height: 28px; font-size: 12px; }
257
+ .sv-ms--md .sv-ms__trigger { min-height: 34px; font-size: 13px; }
258
+ .sv-ms--lg .sv-ms__trigger { min-height: 40px; font-size: 15px; }
259
+ .sv-ms__trigger:focus-visible { outline: none; border-color: var(--_accent); box-shadow: 0 0 0 2px color-mix(in srgb, var(--_accent) 22%, transparent); }
260
+ .sv-ms__trigger.is-invalid { border-color: var(--sg-danger, #dc2626); }
261
+ .sv-ms__placeholder { flex: 1; color: var(--sg-muted, #94a3b8); }
262
+ .sv-ms__chips { flex: 1; display: flex; flex-wrap: wrap; gap: 4px; padding: 4px 0; }
263
+ .sv-ms__chip { display: inline-flex; align-items: center; padding: 1px 7px; border-radius: 999px; font-size: 11.5px; background: color-mix(in srgb, var(--_accent) 14%, transparent); color: var(--_accent); }
264
+ .sv-ms__chip--more { background: var(--sg-row-hover-bg, #f1f5f9); color: var(--sg-muted, #64748b); }
265
+ .sv-ms__arrow { margin-inline-start: auto; color: var(--sg-muted, #64748b); font-size: 10px; }
266
+ .sv-ms__clear { position: absolute; inset-inline-end: 26px; align-self: center; background: none; border: 0; color: var(--sg-muted, #64748b); cursor: pointer; font-size: 15px; }
267
+ .sv-ms__clear:hover { color: var(--sg-fg, #0f172a); }
268
+
269
+ :global(.sv-ms__panel) {
270
+ z-index: 2147483646; display: flex; flex-direction: column; max-height: 300px; max-width: 92vw;
271
+ background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a);
272
+ border: 1px solid var(--sg-border, #e2e8f0); border-radius: 10px; overflow: hidden;
273
+ box-shadow: 0 16px 48px -12px rgba(15, 23, 42, 0.35); font-size: 13px;
274
+ }
275
+ :global(.sv-ms__search) {
276
+ margin: 8px; padding: 6px 9px; font: inherit; font-size: 13px;
277
+ border: 1px solid var(--sg-input-border, #cbd5e1); border-radius: 7px;
278
+ background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a); outline: none;
279
+ }
280
+ :global(.sv-ms__list) { list-style: none; margin: 0; padding: 4px; overflow: auto; flex: 1; outline: none; }
281
+ :global(.sv-ms__opt) { display: flex; align-items: center; gap: 8px; padding: 6px 8px; border-radius: 6px; cursor: pointer; }
282
+ :global(.sv-ms__opt.is-active) { background: var(--sg-row-hover-bg, #f1f5f9); }
283
+ :global(.sv-ms__opt.is-disabled) { opacity: 0.5; cursor: not-allowed; }
284
+ :global(.sv-ms__check) { width: 14px; color: var(--sg-accent, #2563eb); font-weight: 700; }
285
+ :global(.sv-ms__empty) { padding: 10px; color: var(--sg-muted, #94a3b8); text-align: center; }
286
+ :global(.sv-ms__loading) { padding: 8px 10px; color: var(--sg-muted, #94a3b8); font-size: 12px; text-align: center; }
287
+ :global(.sv-ms__footer) { display: flex; justify-content: flex-end; padding: 6px 8px; border-top: 1px solid var(--sg-border, #e2e8f0); }
288
+ :global(.sv-ms__done) { font: inherit; font-size: 12.5px; padding: 4px 12px; border: 0; border-radius: 6px; background: var(--sg-accent, #2563eb); color: var(--sg-on-accent, #fff); cursor: pointer; }
289
+ </style>