@svgrid/grid 2.1.21 → 2.1.23

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 (219) hide show
  1. package/README.md +9 -2
  2. package/dist/DockNodeView.svelte +306 -0
  3. package/dist/DockNodeView.svelte.d.ts +7 -0
  4. package/dist/DockPopoutHost.svelte +17 -0
  5. package/dist/DockPopoutHost.svelte.d.ts +14 -0
  6. package/dist/GridMenus.svelte +83 -3
  7. package/dist/SvAutoComplete.svelte +5 -3
  8. package/dist/SvCarousel.svelte +20 -42
  9. package/dist/SvColorInput.svelte +4 -3
  10. package/dist/SvColorInput.svelte.d.ts +1 -1
  11. package/dist/SvComboBox.svelte +7 -3
  12. package/dist/SvCommand.svelte +28 -85
  13. package/dist/SvCountryInput.svelte +1 -1
  14. package/dist/SvDateRangeInput.svelte +1 -1
  15. package/dist/SvDateTimePicker.svelte +9 -3
  16. package/dist/SvDateTimePicker.svelte.d.ts +3 -0
  17. package/dist/SvDockLayout.svelte +244 -0
  18. package/dist/SvDockLayout.svelte.d.ts +77 -0
  19. package/dist/SvDockManager.svelte +922 -0
  20. package/dist/SvDockManager.svelte.d.ts +106 -0
  21. package/dist/SvDrawer.svelte +69 -47
  22. package/dist/SvDrawer.svelte.d.ts +4 -0
  23. package/dist/SvDropDownList.svelte +85 -13
  24. package/dist/SvDropDownList.svelte.d.ts +3 -0
  25. package/dist/SvField.svelte +21 -4
  26. package/dist/SvField.svelte.d.ts +1 -0
  27. package/dist/SvForm.svelte +201 -91
  28. package/dist/SvForm.svelte.d.ts +15 -22
  29. package/dist/SvGrid.controller.svelte.d.ts +32 -1
  30. package/dist/SvGrid.controller.svelte.js +156 -27
  31. package/dist/SvGrid.css +193 -5
  32. package/dist/SvGrid.svelte +357 -12
  33. package/dist/SvGrid.types.d.ts +452 -1
  34. package/dist/SvGridDropdown.svelte +8 -1
  35. package/dist/SvGridSelect.svelte +1 -0
  36. package/dist/SvListBox.svelte +36 -14
  37. package/dist/SvMaskedInput.svelte +4 -3
  38. package/dist/SvMaskedInput.svelte.d.ts +1 -1
  39. package/dist/SvMenu.svelte +1 -1
  40. package/dist/SvMenuList.svelte +23 -71
  41. package/dist/SvMenuList.svelte.d.ts +2 -13
  42. package/dist/SvModal.svelte +12 -29
  43. package/dist/SvMultiSelect.svelte +1 -0
  44. package/dist/SvNumberInput.svelte +4 -3
  45. package/dist/SvNumberInput.svelte.d.ts +1 -1
  46. package/dist/SvPagination.svelte +18 -18
  47. package/dist/SvPasswordInput.svelte +3 -2
  48. package/dist/SvPasswordInput.svelte.d.ts +1 -1
  49. package/dist/SvPhoneInput.svelte +3 -2
  50. package/dist/SvPhoneInput.svelte.d.ts +1 -1
  51. package/dist/SvPopover.svelte +1 -1
  52. package/dist/SvStepper.svelte +6 -9
  53. package/dist/SvTagsInput.svelte +3 -2
  54. package/dist/SvTagsInput.svelte.d.ts +1 -1
  55. package/dist/SvTooltip.svelte +12 -23
  56. package/dist/SvTour.svelte +32 -4
  57. package/dist/SvTreeSelect.svelte +1 -0
  58. package/dist/build-api.js +76 -54
  59. package/dist/cdn/svgrid.js +10907 -6444
  60. package/dist/cdn/svgrid.svelte-external.js +9622 -5475
  61. package/dist/columns.js +6 -0
  62. package/dist/conditional-formatting.d.ts +67 -3
  63. package/dist/conditional-formatting.js +124 -17
  64. package/dist/createCarousel.svelte.d.ts +72 -0
  65. package/dist/createCarousel.svelte.js +80 -0
  66. package/dist/createCommand.svelte.d.ts +62 -0
  67. package/dist/createCommand.svelte.js +109 -0
  68. package/dist/createForm.svelte.d.ts +62 -0
  69. package/dist/createForm.svelte.js +374 -0
  70. package/dist/createMenu.svelte.d.ts +88 -0
  71. package/dist/createMenu.svelte.js +153 -0
  72. package/dist/createOverlay.svelte.d.ts +38 -0
  73. package/dist/createOverlay.svelte.js +68 -0
  74. package/dist/createPagination.d.ts +74 -0
  75. package/dist/createPagination.js +71 -0
  76. package/dist/createPopoverSelect.svelte.js +6 -12
  77. package/dist/createStepper.d.ts +44 -0
  78. package/dist/createStepper.js +26 -0
  79. package/dist/createTooltip.svelte.d.ts +32 -0
  80. package/dist/createTooltip.svelte.js +61 -0
  81. package/dist/datetime/timezone.d.ts +36 -0
  82. package/dist/datetime/timezone.js +110 -0
  83. package/dist/dock-context.d.ts +52 -0
  84. package/dist/dock-context.js +1 -0
  85. package/dist/dock-manager-model.d.ts +136 -0
  86. package/dist/dock-manager-model.js +514 -0
  87. package/dist/dock-model.d.ts +105 -0
  88. package/dist/dock-model.js +288 -0
  89. package/dist/dock-popout.d.ts +30 -0
  90. package/dist/dock-popout.js +81 -0
  91. package/dist/editor-contract.d.ts +2 -0
  92. package/dist/filter-operators.d.ts +6 -0
  93. package/dist/filter-operators.js +35 -2
  94. package/dist/filtering/excel-filters.d.ts +18 -1
  95. package/dist/filtering/excel-filters.js +56 -0
  96. package/dist/form-field.d.ts +73 -0
  97. package/dist/form-field.js +15 -0
  98. package/dist/index.d.ts +25 -5
  99. package/dist/index.js +40 -4
  100. package/dist/list-nav.d.ts +18 -0
  101. package/dist/list-nav.js +30 -0
  102. package/dist/list-option.d.ts +2 -0
  103. package/dist/menu-item.d.ts +20 -0
  104. package/dist/menu-item.js +1 -0
  105. package/dist/menus.d.ts +5 -0
  106. package/dist/menus.js +68 -16
  107. package/dist/panel-resize.d.ts +25 -0
  108. package/dist/panel-resize.js +40 -0
  109. package/dist/popover.d.ts +29 -3
  110. package/dist/popover.js +22 -6
  111. package/dist/recurrence.d.ts +33 -7
  112. package/dist/recurrence.js +151 -13
  113. package/dist/row-drag.d.ts +8 -0
  114. package/dist/row-drag.js +11 -0
  115. package/dist/scheduler-ical.d.ts +30 -0
  116. package/dist/scheduler-ical.js +180 -0
  117. package/dist/scheduler-model.d.ts +269 -0
  118. package/dist/scheduler-model.js +602 -0
  119. package/dist/scheduler-view.svelte.d.ts +22 -0
  120. package/dist/scheduler-view.svelte.js +13 -0
  121. package/dist/spreadsheet.js +20 -12
  122. package/dist/ui-app.types.d.ts +3 -0
  123. package/package.json +5 -1
  124. package/src/DockNodeView.svelte +306 -0
  125. package/src/DockPopoutHost.svelte +17 -0
  126. package/src/GridMenus.svelte +83 -3
  127. package/src/SvAutoComplete.svelte +5 -3
  128. package/src/SvCarousel.svelte +20 -42
  129. package/src/SvCarousel.test.ts +68 -0
  130. package/src/SvColorInput.svelte +4 -3
  131. package/src/SvComboBox.svelte +7 -3
  132. package/src/SvCommand.svelte +28 -85
  133. package/src/SvCommand.test.ts +78 -0
  134. package/src/SvCountryInput.svelte +1 -1
  135. package/src/SvDateRangeInput.svelte +1 -1
  136. package/src/SvDateTimePicker.svelte +9 -3
  137. package/src/SvDockLayout.svelte +244 -0
  138. package/src/SvDockManager.svelte +922 -0
  139. package/src/SvDrawer.svelte +69 -47
  140. package/src/SvDropDownList.svelte +85 -13
  141. package/src/SvField.svelte +21 -4
  142. package/src/SvForm.svelte +201 -91
  143. package/src/SvForm.test.ts +299 -0
  144. package/src/SvGrid.controller.svelte.ts +152 -28
  145. package/src/SvGrid.css +193 -5
  146. package/src/SvGrid.svelte +357 -12
  147. package/src/SvGrid.types.ts +463 -1
  148. package/src/SvGridDropdown.svelte +8 -1
  149. package/src/SvGridSelect.svelte +1 -0
  150. package/src/SvListBox.svelte +36 -14
  151. package/src/SvMaskedInput.svelte +4 -3
  152. package/src/SvMenu.svelte +1 -1
  153. package/src/SvMenu.test.ts +24 -0
  154. package/src/SvMenuList.svelte +23 -71
  155. package/src/SvModal.svelte +12 -29
  156. package/src/SvModal.test.ts +82 -0
  157. package/src/SvMultiSelect.svelte +1 -0
  158. package/src/SvNumberInput.svelte +4 -3
  159. package/src/SvPagination.svelte +18 -18
  160. package/src/SvPasswordInput.svelte +3 -2
  161. package/src/SvPhoneInput.svelte +3 -2
  162. package/src/SvPopover.svelte +1 -1
  163. package/src/SvStepper.svelte +6 -9
  164. package/src/SvTagsInput.svelte +3 -2
  165. package/src/SvTooltip.svelte +12 -23
  166. package/src/SvTooltip.test.ts +73 -0
  167. package/src/SvTour.svelte +32 -4
  168. package/src/SvTreeSelect.svelte +1 -0
  169. package/src/build-api.ts +74 -51
  170. package/src/columns.ts +5 -0
  171. package/src/conditional-formatting.test.ts +104 -0
  172. package/src/conditional-formatting.ts +176 -19
  173. package/src/createCarousel.svelte.ts +104 -0
  174. package/src/createCommand.svelte.ts +125 -0
  175. package/src/createForm.svelte.ts +333 -0
  176. package/src/createMenu.svelte.ts +202 -0
  177. package/src/createOverlay.svelte.ts +101 -0
  178. package/src/createPagination.test.ts +65 -0
  179. package/src/createPagination.ts +84 -0
  180. package/src/createPopoverSelect.svelte.ts +5 -9
  181. package/src/createStepper.test.ts +62 -0
  182. package/src/createStepper.ts +61 -0
  183. package/src/createTooltip.svelte.ts +86 -0
  184. package/src/datetime/timezone.test.ts +69 -0
  185. package/src/datetime/timezone.ts +134 -0
  186. package/src/dock-context.ts +47 -0
  187. package/src/dock-manager-model.test.ts +275 -0
  188. package/src/dock-manager-model.ts +593 -0
  189. package/src/dock-model.test.ts +163 -0
  190. package/src/dock-model.ts +368 -0
  191. package/src/dock-popout.ts +94 -0
  192. package/src/editor-contract.ts +2 -0
  193. package/src/filter-operators.test.ts +59 -0
  194. package/src/filter-operators.ts +35 -2
  195. package/src/filtering/excel-filters.test.ts +86 -1
  196. package/src/filtering/excel-filters.ts +65 -0
  197. package/src/form-field.ts +87 -0
  198. package/src/index.ts +158 -4
  199. package/src/list-nav.test.ts +49 -0
  200. package/src/list-nav.ts +29 -0
  201. package/src/list-option.ts +2 -0
  202. package/src/menu-item.ts +21 -0
  203. package/src/menus.test.ts +48 -0
  204. package/src/menus.ts +73 -16
  205. package/src/panel-resize.ts +52 -0
  206. package/src/popover.bounds.test.ts +93 -0
  207. package/src/popover.ts +51 -7
  208. package/src/recurrence.test.ts +88 -1
  209. package/src/recurrence.ts +166 -15
  210. package/src/row-drag.ts +10 -0
  211. package/src/scheduler-ical.test.ts +68 -0
  212. package/src/scheduler-ical.ts +180 -0
  213. package/src/scheduler-model.test.ts +546 -0
  214. package/src/scheduler-model.ts +853 -0
  215. package/src/scheduler-view.svelte.ts +33 -0
  216. package/src/spreadsheet.ts +20 -12
  217. package/src/svgrid.effect-driven-filter.svelte.test.ts +116 -0
  218. package/src/ui-app.types.ts +3 -0
  219. package/src/virtual.test.ts +6 -4
@@ -15,11 +15,10 @@
15
15
  * ```
16
16
  */
17
17
  import type { Snippet } from 'svelte'
18
+ import { untrack } from 'svelte'
18
19
  import { portalToBody } from './popover'
19
20
  import { nextEditorId } from './editor-contract'
20
- import { createFocusTrap } from './a11y/focus-trap'
21
- import { lockScroll } from './a11y/scroll-lock'
22
- import { createDismissableLayer } from './a11y/dismissable'
21
+ import { createOverlay } from './createOverlay.svelte'
23
22
 
24
23
  /** Edge the drawer slides from. Kept in sync with the `DrawerSide` export in
25
24
  * index.ts (a bare type-only module script trips the Svelte/Vite parser). */
@@ -43,6 +42,10 @@
43
42
  sheet?: boolean
44
43
  /** Accessible name when there is no visible `title`. */
45
44
  ariaLabel?: string
45
+ /** Fired after the close (exit) animation has finished and the drawer has
46
+ * left the DOM. Use it to clear the data the drawer was showing so the
47
+ * content stays put while it slides out. */
48
+ onClosed?: () => void
46
49
  children?: Snippet
47
50
  footer?: Snippet
48
51
  }
@@ -58,6 +61,7 @@
58
61
  hideClose = false,
59
62
  sheet = false,
60
63
  ariaLabel,
64
+ onClosed,
61
65
  children,
62
66
  footer,
63
67
  }: Props = $props()
@@ -72,6 +76,31 @@
72
76
 
73
77
  function close() { open = false; onClose?.() }
74
78
 
79
+ // Enter/exit animation via CSS @keyframes (the pattern SvModal uses - keyframes
80
+ // play on a `use:portalToBody` element; the Svelte `transition:` directive does
81
+ // NOT). `show` keeps the panel mounted; the enter keyframe fires on mount, and
82
+ // on close we add `is-leaving` (exit keyframe) and unmount + fire `onClosed`
83
+ // after the duration. Honors reduced-motion by dropping the hold to 0ms.
84
+ const reduceMotion = typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches
85
+ const EXIT_MS = 260
86
+ let show = $state(false)
87
+ let leaving = $state(false)
88
+ let leaveTimer: ReturnType<typeof setTimeout> | undefined
89
+ $effect(() => {
90
+ if (open) {
91
+ clearTimeout(leaveTimer)
92
+ leaving = false
93
+ show = true
94
+ return
95
+ }
96
+ // Only run the leave sequence if the drawer was actually shown (skips the
97
+ // initial closed mount, which must not fire onClosed).
98
+ if (untrack(() => show)) {
99
+ leaving = true
100
+ leaveTimer = setTimeout(() => { show = false; leaving = false; onClosed?.() }, reduceMotion ? 0 : EXIT_MS)
101
+ }
102
+ })
103
+
75
104
  // Swipe-down-to-close for the sheet grab handle.
76
105
  let dragY = $state(0)
77
106
  let dragging = $state(false)
@@ -93,41 +122,28 @@
93
122
  else dragY = 0
94
123
  }
95
124
 
96
- // Focus trap + scroll lock + Escape/backdrop dismissal, all from the shared
97
- // primitives - one tested implementation across every dialog-like overlay.
98
- $effect(() => {
99
- if (!open || !dialogEl) return
100
- dragY = 0
101
- const trap = createFocusTrap(dialogEl)
102
- trap.activate()
103
- const unlockScroll = lockScroll()
104
- const layer = createDismissableLayer({
105
- element: () => dialogEl,
106
- onDismiss: (reason) => {
107
- if (reason === 'escape' ? closeOnEsc : closeOnBackdrop) close()
108
- },
109
- })
110
- layer.activate()
111
- return () => {
112
- layer.release()
113
- unlockScroll()
114
- trap.release()
115
- }
125
+ // Focus trap + scroll lock + Escape/backdrop dismissal come from the shared
126
+ // headless overlay core - one tested implementation across every dialog-like
127
+ // overlay, and nested overlays close top-first. See createOverlay.svelte.ts.
128
+ const overlay = createOverlay({
129
+ open: () => open,
130
+ getDialog: () => dialogEl,
131
+ onClose: close,
132
+ closeOnEsc: () => closeOnEsc,
133
+ closeOnBackdrop: () => closeOnBackdrop,
134
+ onOpen: () => { dragY = 0 },
116
135
  })
117
136
  </script>
118
137
 
119
- {#if open}
120
- <div class="sv-drawer__backdrop" use:portalToBody>
138
+ {#if show}
139
+ <div class="sv-drawer__backdrop" class:is-leaving={leaving} use:portalToBody>
121
140
  <div
122
141
  bind:this={dialogEl}
123
142
  class="sv-drawer sv-drawer--{effectiveSide}"
143
+ class:is-leaving={leaving}
124
144
  class:is-sheet={sheet}
125
145
  class:is-dragging={dragging}
126
- role="dialog"
127
- aria-modal="true"
128
- aria-label={!title ? ariaLabel : undefined}
129
- aria-labelledby={title ? titleId : undefined}
130
- tabindex="-1"
146
+ {...overlay.dialogProps({ labelledBy: title ? titleId : undefined, label: !title ? ariaLabel : undefined })}
131
147
  style:--sv-drawer-size={sizeVar}
132
148
  style:transform={sheet && dragY ? `translateY(${dragY}px)` : undefined}
133
149
  >
@@ -160,9 +176,11 @@
160
176
  :global(.sv-drawer__backdrop) {
161
177
  position: fixed; inset: 0; z-index: 2147483000;
162
178
  background: rgba(15, 23, 42, 0.45); backdrop-filter: blur(1.5px);
163
- animation: sv-drawer-fade 0.16s ease both;
179
+ animation: sv-drawer-bd-in 0.2s ease backwards;
164
180
  }
165
- @keyframes sv-drawer-fade { from { opacity: 0 } to { opacity: 1 } }
181
+ :global(.sv-drawer__backdrop.is-leaving) { animation: sv-drawer-bd-out 0.2s ease forwards; }
182
+ @keyframes sv-drawer-bd-in { from { opacity: 0 } to { opacity: 1 } }
183
+ @keyframes sv-drawer-bd-out { from { opacity: 1 } to { opacity: 0 } }
166
184
 
167
185
  :global(.sv-drawer) {
168
186
  position: fixed;
@@ -170,44 +188,48 @@
170
188
  background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a);
171
189
  box-shadow: 0 24px 64px -16px rgba(15, 23, 42, 0.5);
172
190
  overflow: hidden;
191
+ /* Slide in on mount; `backwards` fill shows the off-screen start frame with no
192
+ flash, and does NOT hold the end frame - so the sheet drag transform wins. */
193
+ animation: sv-drawer-in 0.26s cubic-bezier(0.16, 1, 0.3, 1) backwards;
173
194
  }
174
- /* Left / right: full height, fixed width, slide along X. `side` is a stated
175
- physical edge (like SvToaster's position prop), not a text-flow-relative
195
+ /* Exit keyframe; `forwards` fill holds the off-screen frame until we unmount. */
196
+ :global(.sv-drawer.is-leaving) { animation: sv-drawer-out 0.26s cubic-bezier(0.16, 1, 0.3, 1) forwards; }
197
+ /* Off-screen vector per edge - the enter/exit keyframes read `--sv-off`. `side`
198
+ is a stated physical edge (like SvToaster's position prop), not a text-flow
176
199
  "start/end" - so it stays physical left/right regardless of page dir. */
177
200
  :global(.sv-drawer--right), :global(.sv-drawer--left) {
178
201
  top: 0; bottom: 0; width: var(--sv-drawer-size); max-width: 100vw;
179
202
  }
180
- :global(.sv-drawer--right) { right: 0; border-left: 1px solid var(--sg-border, #e2e8f0); animation: sv-drawer-in-right 0.22s cubic-bezier(0.16, 1, 0.3, 1) both; }
181
- :global(.sv-drawer--left) { left: 0; border-right: 1px solid var(--sg-border, #e2e8f0); animation: sv-drawer-in-left 0.22s cubic-bezier(0.16, 1, 0.3, 1) both; }
203
+ :global(.sv-drawer--right) { right: 0; border-left: 1px solid var(--sg-border, #e2e8f0); --sv-off: translateX(100%); }
204
+ :global(.sv-drawer--left) { left: 0; border-right: 1px solid var(--sg-border, #e2e8f0); --sv-off: translateX(-100%); }
182
205
  /* Top / bottom: full width, fixed height, slide along Y. */
183
206
  :global(.sv-drawer--top), :global(.sv-drawer--bottom) {
184
207
  left: 0; right: 0; height: var(--sv-drawer-size); max-height: 100vh;
185
208
  }
186
- :global(.sv-drawer--top) { top: 0; border-bottom: 1px solid var(--sg-border, #e2e8f0); animation: sv-drawer-in-top 0.22s cubic-bezier(0.16, 1, 0.3, 1) both; }
187
- :global(.sv-drawer--bottom) { bottom: 0; border-top: 1px solid var(--sg-border, #e2e8f0); animation: sv-drawer-in-bottom 0.22s cubic-bezier(0.16, 1, 0.3, 1) both; }
209
+ :global(.sv-drawer--top) { top: 0; border-bottom: 1px solid var(--sg-border, #e2e8f0); --sv-off: translateY(-100%); }
210
+ :global(.sv-drawer--bottom) { bottom: 0; border-top: 1px solid var(--sg-border, #e2e8f0); --sv-off: translateY(100%); }
211
+ @keyframes sv-drawer-in { from { transform: var(--sv-off) } to { transform: none } }
212
+ @keyframes sv-drawer-out { from { transform: none } to { transform: var(--sv-off) } }
188
213
 
189
- /* Mobile bottom-sheet: centered, fixed width, rounded top, grab handle. */
214
+ /* Mobile bottom-sheet: centered, fixed width, rounded top, grab handle. Slides
215
+ along Y like a bottom drawer (enter/exit keyframes read --sv-off from --bottom). */
190
216
  :global(.sv-drawer.is-sheet) {
191
217
  left: 0; right: 0; margin: 0 auto; top: auto;
192
218
  width: min(560px, 100vw); height: auto; max-height: 85vh;
193
219
  border: 1px solid var(--sg-border, #e2e8f0); border-bottom: 0;
194
220
  border-radius: 16px 16px 0 0;
195
- transition: transform 0.22s cubic-bezier(0.16, 1, 0.3, 1);
196
221
  }
197
- :global(.sv-drawer.is-sheet.is-dragging) { transition: none; }
222
+ /* No transition while the user is dragging the grab handle - follow the finger. */
223
+ :global(.sv-drawer.is-dragging) { transition: none; }
198
224
  :global(.sv-drawer__grab) {
199
225
  flex: none; display: grid; place-items: center; padding: 8px 0 2px; cursor: grab; touch-action: none;
200
226
  }
201
227
  :global(.sv-drawer__grab span) {
202
228
  display: block; width: 40px; height: 4px; border-radius: 999px; background: var(--sg-border, #cbd5e1);
203
229
  }
204
-
205
- @keyframes sv-drawer-in-right { from { transform: translateX(100%) } to { transform: translateX(0) } }
206
- @keyframes sv-drawer-in-left { from { transform: translateX(-100%) } to { transform: translateX(0) } }
207
- @keyframes sv-drawer-in-top { from { transform: translateY(-100%) } to { transform: translateY(0) } }
208
- @keyframes sv-drawer-in-bottom { from { transform: translateY(100%) } to { transform: translateY(0) } }
209
230
  @media (prefers-reduced-motion: reduce) {
210
- :global(.sv-drawer__backdrop), :global(.sv-drawer) { animation: none }
231
+ :global(.sv-drawer__backdrop), :global(.sv-drawer__backdrop.is-leaving),
232
+ :global(.sv-drawer), :global(.sv-drawer.is-leaving) { animation: none; }
211
233
  }
212
234
 
213
235
  :global(.sv-drawer__header) {
@@ -7,8 +7,8 @@
7
7
  * One styled renderer over the headless `createDropdownList` core (state +
8
8
  * keyboard + ARIA); only portal/measure/scroll render concerns live here.
9
9
  */
10
- import { flushSync } from 'svelte'
11
10
  import { anchoredRect, portalToBody, popIn, type AnchoredRect } from './popover'
11
+ import { startPanelResize } from './panel-resize'
12
12
  import { createDismissableLayer } from './a11y/dismissable'
13
13
  import { groupOptions, hasGroups, type ListOption } from './list-option'
14
14
  import { virtualRange, scrollToIndex } from './virtual'
@@ -26,6 +26,9 @@
26
26
  virtual?: boolean
27
27
  /** Fixed option height in px (must match the CSS). Default 34. */
28
28
  rowHeight?: number
29
+ /** Show a bottom drag grip so the user can resize the open panel's height
30
+ * (only while it opens downward). Off by default. */
31
+ resizable?: boolean
29
32
  }
30
33
 
31
34
  let {
@@ -47,6 +50,7 @@
47
50
  autoOpen = false,
48
51
  virtual = false,
49
52
  rowHeight = 34,
53
+ resizable = false,
50
54
  }: Props = $props()
51
55
 
52
56
  const autoId = nextEditorId('sv-ddl')
@@ -61,7 +65,15 @@
61
65
 
62
66
  let triggerEl = $state<HTMLButtonElement | null>(null)
63
67
  let panelEl = $state<HTMLDivElement | null>(null)
64
- let rect = $state<AnchoredRect>({ top: 0, left: 0, width: 0, openUpward: false })
68
+ let rect = $state<AnchoredRect>({ top: 0, left: 0, width: 0, openUpward: false, maxHeight: 0, availHeight: 0 })
69
+ // User-chosen panel height (px) once they drag the resize grip; null = auto.
70
+ let userHeight = $state<number | null>(null)
71
+ // Effective height cap: the user's drag if any (clamped to the viewport
72
+ // ceiling), otherwise the comfortable bounds-aware height.
73
+ const panelMaxH = $derived(
74
+ resizable && userHeight != null ? Math.min(userHeight, rect.availHeight) : rect.maxHeight,
75
+ )
76
+ const showGrip = $derived(resizable && !rect.openUpward)
65
77
 
66
78
  const ddl = createDropdownList({
67
79
  options: () => options,
@@ -81,7 +93,24 @@
81
93
 
82
94
  function updatePos() {
83
95
  if (!triggerEl) return
84
- rect = anchoredRect(triggerEl.getBoundingClientRect(), { estimatedHeight: Math.min(options.length, 8) * 34 + 8 })
96
+ // When the user has resized, anchor to THAT height so the flip decision and
97
+ // upward top stay correct; otherwise estimate from the option count.
98
+ const estimatedHeight =
99
+ resizable && userHeight != null ? userHeight : Math.min(options.length, 8) * 34 + 8
100
+ rect = anchoredRect(triggerEl.getBoundingClientRect(), { estimatedHeight })
101
+ }
102
+
103
+ function startResize(e: PointerEvent) {
104
+ if (!panelEl) return
105
+ startPanelResize(e, {
106
+ startHeight: panelEl.clientHeight,
107
+ min: 96,
108
+ max: () => rect.availHeight,
109
+ onHeight: (h) => {
110
+ userHeight = h
111
+ updatePos()
112
+ },
113
+ })
85
114
  }
86
115
 
87
116
  $effect(() => {
@@ -126,19 +155,20 @@
126
155
  {...ddl.triggerProps()}
127
156
  use:focusOpen
128
157
  >
129
- <span class="sv-ddl__value" class:is-placeholder={!selected}>{selected?.label ?? placeholder}</span>
158
+ <span class="sv-ddl__value" class:is-placeholder={!selected}>{#if selected?.color}<span class="sv-ddl__swatch" style:background={selected.color}></span>{/if}{selected?.label ?? placeholder}</span>
130
159
  <svg class="sv-ddl__chev" viewBox="0 0 24 24" width="15" height="15" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6" /></svg>
131
160
  </button>
132
161
  </SvField>
133
162
 
134
163
  {#if ddl.open}
135
- <div bind:this={panelEl} class="sv-ddl__panel" class:is-virtual={useVirtual} use:portalToBody use:popIn={{ up: rect.openUpward }} style:position="fixed" style:top={`${rect.top}px`} style:left={`${rect.left}px`} style:min-width={`${rect.width}px`} onscroll={(e) => { scrollTop = e.currentTarget.scrollTop; if (useVirtual) flushSync() }} bind:clientHeight={viewportH} {...ddl.listboxProps()}>
164
+ <div bind:this={panelEl} class="sv-ddl__panel" class:is-virtual={useVirtual} class:is-resizable={showGrip} use:portalToBody use:popIn={{ up: rect.openUpward }} style:--sv-row-h={`${rowHeight}px`} style:position="fixed" style:top={`${rect.top}px`} style:left={`${rect.left}px`} style:min-width={`${rect.width}px`} style:max-height={`${panelMaxH}px`} style:height={resizable && userHeight != null ? `${panelMaxH}px` : undefined} onscroll={(e) => (scrollTop = e.currentTarget.scrollTop)} bind:clientHeight={viewportH} {...ddl.listboxProps()}>
136
165
  {#if useVirtual}
137
- <div class="sv-ddl__sizer" aria-hidden="true" style:height={`${vr.totalHeight}px`}></div>
166
+ <div class="sv-ddl__spacer" aria-hidden="true" style:height={`${vr.padTop}px`}></div>
138
167
  {#each windowed as opt (opt.value)}
139
168
  <!-- svelte-ignore a11y_click_events_have_key_events a11y_interactive_supports_focus -->
140
- <div class="sv-ddl__opt sv-ddl__opt--abs" style:height={`${rowHeight}px`} style:transform={`translateY(${opt.index * rowHeight}px)`} class:is-active={ddl.isActive(opt.index)} class:is-selected={ddl.isSelected(opt)} class:is-disabled={opt.disabled} {...ddl.optionProps(opt.index)}>{opt.label}</div>
169
+ <div class="sv-ddl__opt" style:height={`${rowHeight}px`} class:is-active={ddl.isActive(opt.index)} class:is-selected={ddl.isSelected(opt)} class:is-disabled={opt.disabled} {...ddl.optionProps(opt.index)}>{#if opt.color}<span class="sv-ddl__swatch" style:background={opt.color}></span>{/if}{opt.label}</div>
141
170
  {/each}
171
+ <div class="sv-ddl__spacer" aria-hidden="true" style:height={`${vr.padBottom}px`}></div>
142
172
  {:else}
143
173
  {#each groupOptions(options) as g (g.group ?? '')}
144
174
  {#if g.group != null}
@@ -146,17 +176,23 @@
146
176
  <div class="sv-ddl__group-label" aria-hidden="true">{g.group}</div>
147
177
  {#each g.options as opt (opt.value)}
148
178
  <!-- svelte-ignore a11y_click_events_have_key_events a11y_interactive_supports_focus -->
149
- <div class="sv-ddl__opt" class:is-active={ddl.isActive(opt.index)} class:is-selected={ddl.isSelected(opt)} class:is-disabled={opt.disabled} {...ddl.optionProps(opt.index)}>{opt.label}</div>
179
+ <div class="sv-ddl__opt" class:is-active={ddl.isActive(opt.index)} class:is-selected={ddl.isSelected(opt)} class:is-disabled={opt.disabled} {...ddl.optionProps(opt.index)}>{#if opt.color}<span class="sv-ddl__swatch" style:background={opt.color}></span>{/if}{opt.label}</div>
150
180
  {/each}
151
181
  </div>
152
182
  {:else}
153
183
  {#each g.options as opt (opt.value)}
154
184
  <!-- svelte-ignore a11y_click_events_have_key_events a11y_interactive_supports_focus -->
155
- <div class="sv-ddl__opt" class:is-active={ddl.isActive(opt.index)} class:is-selected={ddl.isSelected(opt)} class:is-disabled={opt.disabled} {...ddl.optionProps(opt.index)}>{opt.label}</div>
185
+ <div class="sv-ddl__opt" class:is-active={ddl.isActive(opt.index)} class:is-selected={ddl.isSelected(opt)} class:is-disabled={opt.disabled} {...ddl.optionProps(opt.index)}>{#if opt.color}<span class="sv-ddl__swatch" style:background={opt.color}></span>{/if}{opt.label}</div>
156
186
  {/each}
157
187
  {/if}
158
188
  {/each}
159
189
  {/if}
190
+ {#if showGrip}
191
+ <!-- svelte-ignore a11y_no_static_element_interactions -->
192
+ <div class="sv-ddl__grip" onpointerdown={startResize} title="Drag to resize" aria-hidden="true">
193
+ <span class="sv-ddl__grip-dots"></span>
194
+ </div>
195
+ {/if}
160
196
  </div>
161
197
  {/if}
162
198
  {#if name}<input type="hidden" {name} value={value ?? ''} />{/if}
@@ -181,14 +217,50 @@
181
217
  .sv-ddl__chev { color: var(--sg-muted, #64748b); flex: none; }
182
218
 
183
219
  :global(.sv-ddl__panel) {
184
- z-index: 2147483647; max-height: 288px; overflow-y: auto; padding: 4px;
220
+ box-sizing: border-box; z-index: 2147483647; max-height: 288px; overflow-y: auto; padding: 4px;
185
221
  background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a);
186
222
  border: 1px solid var(--sg-border, #e2e8f0); border-radius: 10px; box-shadow: 0 16px 48px -12px rgba(15,23,42,0.35);
187
223
  }
188
224
  :global(.sv-ddl__opt) { box-sizing: border-box; display: flex; align-items: center; padding: 7px 10px; border-radius: 6px; cursor: pointer; font-size: 13px; }
189
- :global(.sv-ddl__panel.is-virtual) { position: fixed; will-change: scroll-position; }
190
- :global(.sv-ddl__sizer) { padding: 0; margin: 0; pointer-events: none; }
191
- :global(.sv-ddl__opt--abs) { position: absolute; inset-inline: 4px; top: 4px; }
225
+ /* Color swatch shown before an option's label (option.color) - in both the
226
+ trigger value and the portalled panel options. */
227
+ :global(.sv-ddl__swatch) {
228
+ display: inline-block; flex: none; width: 10px; height: 10px; border-radius: 3px;
229
+ margin-inline-end: 8px; vertical-align: middle;
230
+ box-shadow: inset 0 0 0 1px color-mix(in srgb, #000 18%, transparent);
231
+ }
232
+ /* Bottom resize grip: a row of dots ("····") the user drags to resize the
233
+ panel. Sticky so it stays pinned at the panel's bottom while options scroll. */
234
+ :global(.sv-ddl__panel.is-resizable) { padding-bottom: 0; }
235
+ :global(.sv-ddl__grip) {
236
+ position: sticky; bottom: 0; z-index: 1; margin: 2px -4px -4px; height: 15px;
237
+ display: flex; align-items: center; justify-content: center; cursor: ns-resize;
238
+ background: var(--sg-bg, #fff); border-top: 1px solid var(--sg-border, #e2e8f0);
239
+ border-radius: 0 0 10px 10px; touch-action: none;
240
+ }
241
+ :global(.sv-ddl__grip-dots) {
242
+ width: 26px; height: 4px; color: var(--sg-muted, #94a3b8); opacity: 0.6;
243
+ background-image: radial-gradient(currentColor 1px, transparent 1.6px);
244
+ background-size: 6px 4px; background-position: center; background-repeat: repeat-x;
245
+ }
246
+ :global(.sv-ddl__grip:hover .sv-ddl__grip-dots) { opacity: 1; }
247
+ /* Faint per-row skeleton so a fast scrollbar-thumb drag reveals placeholder
248
+ rows in this off-screen padding instead of blank, until JS re-windows. */
249
+ :global(.sv-ddl__spacer) {
250
+ padding: 0; margin: 0; flex: none; pointer-events: none;
251
+ background-image: linear-gradient(
252
+ to bottom,
253
+ transparent 0,
254
+ transparent calc((var(--sv-row-h, 34px) - 10px) / 2),
255
+ var(--sg-skeleton, color-mix(in srgb, currentColor 9%, transparent)) calc((var(--sv-row-h, 34px) - 10px) / 2),
256
+ var(--sg-skeleton, color-mix(in srgb, currentColor 9%, transparent)) calc((var(--sv-row-h, 34px) + 10px) / 2),
257
+ transparent calc((var(--sv-row-h, 34px) + 10px) / 2),
258
+ transparent var(--sv-row-h, 34px)
259
+ );
260
+ background-size: 62% var(--sv-row-h, 34px);
261
+ background-repeat: repeat-y;
262
+ background-position: 12px 0;
263
+ }
192
264
  :global(.sv-ddl__opt.is-active) { background: var(--sg-row-hover-bg, #f1f5f9); }
193
265
  :global(.sv-ddl__opt.is-selected) { color: var(--sg-accent, #2563eb); font-weight: 600; }
194
266
  :global(.sv-ddl__opt.is-disabled) { opacity: 0.4; cursor: not-allowed; }
@@ -26,6 +26,8 @@
26
26
  dir,
27
27
  /** Stretch the field (and its control) to the container width. */
28
28
  block = false,
29
+ /** Busy state - shows a small spinner beside the label. */
30
+ loading = false,
29
31
  children,
30
32
  }: {
31
33
  id?: string
@@ -35,6 +37,7 @@
35
37
  required?: boolean
36
38
  dir?: EditorDir
37
39
  block?: boolean
40
+ loading?: boolean
38
41
  children: Snippet
39
42
  } = $props()
40
43
 
@@ -43,10 +46,15 @@
43
46
  </script>
44
47
 
45
48
  <div class="sv-field" class:sv-field--block={block} dir={resolvedDir}>
46
- {#if label}
47
- <label class="sv-field__label" for={id}>
48
- {label}{#if required}<span class="sv-field__req" aria-hidden="true">*</span>{/if}
49
- </label>
49
+ {#if label || loading}
50
+ <span class="sv-field__labelrow">
51
+ {#if label}
52
+ <label class="sv-field__label" for={id}>
53
+ {label}{#if required}<span class="sv-field__req" aria-hidden="true">*</span>{/if}
54
+ </label>
55
+ {/if}
56
+ {#if loading}<span class="sv-field__spinner" role="status" aria-label="Loading"></span>{/if}
57
+ </span>
50
58
  {/if}
51
59
  {@render children()}
52
60
  {#if error}
@@ -64,12 +72,21 @@
64
72
  text-align: start;
65
73
  }
66
74
  .sv-field--block { display: flex; width: 100%; }
75
+ .sv-field__labelrow { display: inline-flex; align-items: center; gap: 6px; }
67
76
  .sv-field__label {
68
77
  font-size: 12.5px;
69
78
  font-weight: 550;
70
79
  color: var(--sg-fg, #0f172a);
71
80
  line-height: 1.3;
72
81
  }
82
+ .sv-field__spinner {
83
+ width: 12px; height: 12px; flex: none; border-radius: 50%;
84
+ border: 2px solid color-mix(in srgb, var(--sg-accent, #2563eb) 30%, transparent);
85
+ border-top-color: var(--sg-accent, #2563eb);
86
+ animation: sv-field-spin 0.6s linear infinite;
87
+ }
88
+ @keyframes sv-field-spin { to { transform: rotate(360deg); } }
89
+ @media (prefers-reduced-motion: reduce) { .sv-field__spinner { animation: none; } }
73
90
  .sv-field__req { color: var(--sg-danger, #dc2626); margin-inline-start: 2px; }
74
91
  .sv-field__hint {
75
92
  font-size: 11.5px;