@svgrid/grid 2.7.0 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (264) hide show
  1. package/CHANGELOG.md +116 -88
  2. package/README.md +199 -199
  3. package/dist/FlexRender.svelte +96 -96
  4. package/dist/GridFooter.svelte +181 -181
  5. package/dist/SvAutoComplete.svelte +169 -169
  6. package/dist/SvAvatar.svelte +75 -75
  7. package/dist/SvCalendar.svelte +503 -503
  8. package/dist/SvCarousel.svelte +141 -141
  9. package/dist/SvCheckBox.svelte +102 -102
  10. package/dist/SvCircularProgress.svelte +109 -109
  11. package/dist/SvColorInput.svelte +181 -181
  12. package/dist/SvComboBox.svelte +279 -279
  13. package/dist/SvContextMenu.svelte +116 -116
  14. package/dist/SvCountryInput.svelte +163 -163
  15. package/dist/SvDrawer.svelte +254 -254
  16. package/dist/SvDropDownList.svelte +378 -378
  17. package/dist/SvDurationInput.svelte +126 -126
  18. package/dist/SvField.svelte +293 -293
  19. package/dist/SvForm.svelte +437 -437
  20. package/dist/SvGridCellEditor.svelte +748 -744
  21. package/dist/SvGridChart.svelte +1716 -1716
  22. package/dist/SvGridChartPanel.svelte +485 -485
  23. package/dist/SvGridChartView.svelte +70 -70
  24. package/dist/SvGridDropdown.svelte +728 -728
  25. package/dist/SvGridSelect.svelte +270 -270
  26. package/dist/SvGroupCell.svelte +116 -116
  27. package/dist/SvListBox.svelte +334 -334
  28. package/dist/SvMaskedInput.svelte +122 -122
  29. package/dist/SvMenu.svelte +124 -124
  30. package/dist/SvMenuList.svelte +146 -146
  31. package/dist/SvMultiSelect.svelte +293 -293
  32. package/dist/SvNumberInput.svelte +172 -172
  33. package/dist/SvOtpInput.svelte +158 -158
  34. package/dist/SvPasswordInput.svelte +151 -151
  35. package/dist/SvPhoneInput.svelte +133 -133
  36. package/dist/SvPopover.svelte +197 -197
  37. package/dist/SvProgress.svelte +116 -116
  38. package/dist/SvRadioGroup.svelte +107 -107
  39. package/dist/SvRating.svelte +112 -112
  40. package/dist/SvResult.svelte +73 -73
  41. package/dist/SvRichText.svelte +211 -211
  42. package/dist/SvRowGroupPanel.svelte +170 -170
  43. package/dist/SvScrollArea.svelte +61 -61
  44. package/dist/SvSlider.svelte +203 -203
  45. package/dist/SvSwitchButton.svelte +108 -108
  46. package/dist/SvTagsInput.svelte +115 -115
  47. package/dist/SvTextInput.svelte +147 -147
  48. package/dist/SvTimePicker.svelte +245 -245
  49. package/dist/SvToaster.svelte +159 -159
  50. package/dist/SvToggleButton.svelte +85 -85
  51. package/dist/SvTooltip.svelte +161 -161
  52. package/dist/SvTour.svelte +208 -208
  53. package/dist/SvTree.svelte +444 -444
  54. package/dist/SvTreeSelect.svelte +239 -239
  55. package/dist/cdn/{GridMenus-C4oLsJyj.js → GridMenus-CYzOvmNQ.js} +3 -3
  56. package/dist/cdn/{GridMenus-yEivjNwl.js → GridMenus-DFB6iwF8.js} +3 -3
  57. package/dist/cdn/{SvDateRangeInput-DflbiP7N.js → SvDateRangeInput-CaOuMs8O.js} +1 -1
  58. package/dist/cdn/{SvDateRangeInput-Bh0A0JkF.js → SvDateRangeInput-DMLKmGEc.js} +1 -1
  59. package/dist/cdn/{SvDateTimePicker-Bivn8dAP.js → SvDateTimePicker-CCbDZNZB.js} +1 -1
  60. package/dist/cdn/{SvDateTimePicker-BWwpfB_o.js → SvDateTimePicker-sonaH0oh.js} +1 -1
  61. package/dist/cdn/{SvGridCellEditor-Ba7rY3eu.js → SvGridCellEditor-BWnTi2N7.js} +2 -2
  62. package/dist/cdn/{SvGridCellEditor-AXL8cHGO.js → SvGridCellEditor-CjEJMJKc.js} +2 -2
  63. package/dist/cdn/{SvGridChart-CwhFz7GV.js → SvGridChart-BEJmNNx9.js} +1 -1
  64. package/dist/cdn/{SvGridChart-Bs2GIR2Q.js → SvGridChart-BwVos976.js} +1 -1
  65. package/dist/cdn/{SvGridChartPanel-1WXuStzM.js → SvGridChartPanel-BOknOkrP.js} +1 -1
  66. package/dist/cdn/{SvGridChartPanel-e5_nqNP9.js → SvGridChartPanel-D2PjII4O.js} +1 -1
  67. package/dist/cdn/{SvGridChartView-SmPW10dI.js → SvGridChartView-00LPUHL1.js} +1 -1
  68. package/dist/cdn/{SvGridChartView-eSPuJE6g.js → SvGridChartView-BhUEJ5ki.js} +1 -1
  69. package/dist/cdn/{SvGridDropdown-B1ZcLpgs.js → SvGridDropdown-D0VdjeR8.js} +1 -1
  70. package/dist/cdn/{SvGridDropdown-CtdbHcIS.js → SvGridDropdown-D13MtJ2j.js} +1 -1
  71. package/dist/cdn/{date-format-DZT7T1wf.js → date-format-BNii4zeD.js} +2 -2
  72. package/dist/cdn/{date-format-CcP1tafP.js → date-format-BnnHlqGw.js} +2 -2
  73. package/dist/cdn/{row-drag-touch-Ddaa-QeB.js → row-drag-touch-CycRR65n.js} +12 -10
  74. package/dist/cdn/{src-COC0vnpg.js → src-C8QjSaq-.js} +53 -55
  75. package/dist/cdn/{src-pYGV2rMR.js → src-D0hO2eYN.js} +52 -54
  76. package/dist/cdn/svgrid.js +7 -7
  77. package/dist/cdn/svgrid.svelte-external.js +7 -7
  78. package/dist/chart-export.js +8 -8
  79. package/dist/editing.js +22 -13
  80. package/dist/row-drag-touch.d.ts +5 -1
  81. package/dist/row-drag-touch.js +15 -4
  82. package/dist/row-drag.js +7 -3
  83. package/package.json +11 -11
  84. package/src/FlexRender.svelte +96 -96
  85. package/src/GridFooter.svelte +181 -181
  86. package/src/SvAutoComplete.svelte +169 -169
  87. package/src/SvAvatar.svelte +75 -75
  88. package/src/SvCalendar.svelte +503 -503
  89. package/src/SvCalendar.test.ts +226 -226
  90. package/src/SvCarousel.svelte +141 -141
  91. package/src/SvCheckBox.svelte +102 -102
  92. package/src/SvCircularProgress.svelte +109 -109
  93. package/src/SvColorInput.svelte +181 -181
  94. package/src/SvComboBox.svelte +279 -279
  95. package/src/SvContextMenu.svelte +116 -116
  96. package/src/SvCountryInput.svelte +163 -163
  97. package/src/SvDrawer.svelte +254 -254
  98. package/src/SvDropDownList.svelte +378 -378
  99. package/src/SvDurationInput.svelte +126 -126
  100. package/src/SvField.svelte +293 -293
  101. package/src/SvForm.svelte +437 -437
  102. package/src/SvForm.test.ts +411 -411
  103. package/src/SvGrid.types.ts +2092 -2092
  104. package/src/SvGridCellEditor.svelte +748 -744
  105. package/src/SvGridChart.svelte +1716 -1716
  106. package/src/SvGridChartPanel.svelte +485 -485
  107. package/src/SvGridChartView.svelte +70 -70
  108. package/src/SvGridDropdown.svelte +728 -728
  109. package/src/SvGridSelect.svelte +270 -270
  110. package/src/SvGroupCell.svelte +116 -116
  111. package/src/SvListBox.svelte +334 -334
  112. package/src/SvMaskedInput.svelte +122 -122
  113. package/src/SvMenu.svelte +124 -124
  114. package/src/SvMenu.test.ts +97 -97
  115. package/src/SvMenuList.svelte +146 -146
  116. package/src/SvMultiSelect.svelte +293 -293
  117. package/src/SvNumberInput.svelte +172 -172
  118. package/src/SvOtpInput.svelte +158 -158
  119. package/src/SvPasswordInput.svelte +151 -151
  120. package/src/SvPhoneInput.svelte +133 -133
  121. package/src/SvPopover.svelte +197 -197
  122. package/src/SvProgress.svelte +116 -116
  123. package/src/SvRadioGroup.svelte +107 -107
  124. package/src/SvRating.svelte +112 -112
  125. package/src/SvResult.svelte +73 -73
  126. package/src/SvRichText.svelte +211 -211
  127. package/src/SvRowGroupPanel.svelte +170 -170
  128. package/src/SvScrollArea.svelte +61 -61
  129. package/src/SvSlider.svelte +203 -203
  130. package/src/SvSwitchButton.svelte +108 -108
  131. package/src/SvTagsInput.svelte +115 -115
  132. package/src/SvTextInput.svelte +147 -147
  133. package/src/SvTimePicker.svelte +245 -245
  134. package/src/SvToaster.svelte +159 -159
  135. package/src/SvToaster.test.ts +95 -95
  136. package/src/SvToggleButton.svelte +85 -85
  137. package/src/SvTooltip.svelte +161 -161
  138. package/src/SvTour.svelte +208 -208
  139. package/src/SvTree.svelte +444 -444
  140. package/src/SvTreeSelect.svelte +239 -239
  141. package/src/a11y/dismissable.test.ts +119 -119
  142. package/src/a11y/dismissable.ts +114 -114
  143. package/src/a11y.contract.test.ts +49 -49
  144. package/src/a11y.test.ts +59 -59
  145. package/src/a11y.ts +61 -61
  146. package/src/ai.test.ts +502 -502
  147. package/src/ai.ts +1419 -1419
  148. package/src/build-api.coverage.test.ts +633 -633
  149. package/src/build-api.ts +846 -846
  150. package/src/builtin-editors.grid.test.ts +83 -83
  151. package/src/cell-formatting.ts +171 -171
  152. package/src/cell-render.test.ts +513 -513
  153. package/src/cell-render.ts +496 -496
  154. package/src/cell-values.ts +148 -148
  155. package/src/chart-export.ts +202 -202
  156. package/src/chart-view.svelte.ts +36 -36
  157. package/src/chart.ts +2321 -2321
  158. package/src/collaboration.test.ts +104 -104
  159. package/src/collaboration.ts +167 -167
  160. package/src/column-groups.ts +78 -78
  161. package/src/core.performance.test.ts +30 -30
  162. package/src/core.ts +1865 -1865
  163. package/src/createAutocomplete.svelte.ts +132 -132
  164. package/src/createCombobox.svelte.ts +191 -191
  165. package/src/createCountryInput.svelte.ts +157 -157
  166. package/src/createDropdownList.svelte.ts +168 -168
  167. package/src/createForm.svelte.ts +386 -386
  168. package/src/createGrid.svelte.ts +42 -42
  169. package/src/createGrid.test.ts +10 -10
  170. package/src/createGridState.svelte.ts +17 -17
  171. package/src/createListbox.svelte.ts +250 -250
  172. package/src/createMenu.svelte.ts +224 -224
  173. package/src/createPopoverSelect.svelte.ts +213 -213
  174. package/src/createSlider.svelte.ts +191 -191
  175. package/src/createTooltip.svelte.ts +144 -144
  176. package/src/createTree.svelte.ts +322 -322
  177. package/src/datetime/date-core.ts +206 -206
  178. package/src/datetime/date-restrict.ts +61 -61
  179. package/src/datetime/timezone.ts +135 -135
  180. package/src/dock-manager-model.ts +596 -596
  181. package/src/dock-model.ts +374 -374
  182. package/src/editing.test.ts +974 -974
  183. package/src/editing.ts +618 -609
  184. package/src/editor-contract.ts +171 -171
  185. package/src/editor-registry.grid.test.ts +144 -144
  186. package/src/editor-registry.ts +122 -122
  187. package/src/export-data-api.test.ts +126 -126
  188. package/src/export-format.test.ts +107 -107
  189. package/src/export-format.ts +601 -601
  190. package/src/filter-operators.ts +160 -160
  191. package/src/filtering/excel-filters.ts +325 -325
  192. package/src/flex-render.ts +3 -3
  193. package/src/form-field.ts +127 -127
  194. package/src/group-display.test.ts +167 -167
  195. package/src/group-display.ts +200 -200
  196. package/src/headless.ts +87 -87
  197. package/src/js-scroller.svelte.ts +173 -173
  198. package/src/keyboard-handlers.ts +270 -270
  199. package/src/keyboard.test.ts +59 -59
  200. package/src/keyboard.ts +97 -97
  201. package/src/list-nav.test.ts +49 -49
  202. package/src/list-nav.ts +29 -29
  203. package/src/list-option.test.ts +56 -56
  204. package/src/list-option.ts +179 -179
  205. package/src/menus.ts +597 -597
  206. package/src/merge-objects.ts +48 -48
  207. package/src/overlays.test.ts +90 -90
  208. package/src/positioning.ts +268 -268
  209. package/src/render-component.ts +28 -28
  210. package/src/row-drag-touch.ts +226 -211
  211. package/src/row-drag.test.ts +401 -353
  212. package/src/row-drag.ts +419 -415
  213. package/src/row-resize.test.ts +524 -524
  214. package/src/row-resize.ts +228 -228
  215. package/src/scheduler-ical.ts +181 -181
  216. package/src/scheduler-model.test.ts +562 -562
  217. package/src/scheduler-model.ts +873 -873
  218. package/src/selection.test.ts +885 -885
  219. package/src/server-data-source.test.ts +383 -383
  220. package/src/server-data-source.ts +469 -469
  221. package/src/sparkline.test.ts +68 -68
  222. package/src/sparkline.ts +169 -169
  223. package/src/spreadsheet.test.ts +488 -488
  224. package/src/spreadsheet.ts +312 -312
  225. package/src/static-functions.ts +11 -11
  226. package/src/subscribe.ts +38 -38
  227. package/src/summaries.ts +113 -113
  228. package/src/svgrid-wrapper.types.ts +563 -563
  229. package/src/svgrid.async-editor-options.test.ts +273 -273
  230. package/src/svgrid.auto-row-height.test.ts +204 -204
  231. package/src/svgrid.behavior.test.ts +910 -910
  232. package/src/svgrid.charting.test.ts +534 -534
  233. package/src/svgrid.comments-autocomplete.test.ts +127 -127
  234. package/src/svgrid.context-menu.test.ts +147 -147
  235. package/src/svgrid.features.test.ts +157 -157
  236. package/src/svgrid.filter-depth.test.ts +163 -163
  237. package/src/svgrid.filter-menu-listbox.svelte.test.ts +382 -377
  238. package/src/svgrid.filter-menu-scroll.test.ts +112 -112
  239. package/src/svgrid.grand-total.test.ts +188 -188
  240. package/src/svgrid.group-display-mode.test.ts +171 -171
  241. package/src/svgrid.group-footers.test.ts +121 -121
  242. package/src/svgrid.group-pagination.test.ts +153 -153
  243. package/src/svgrid.new-features.wrapper.test.ts +251 -251
  244. package/src/svgrid.tree-data.test.ts +186 -186
  245. package/src/svgrid.wrapper.test.ts +63 -63
  246. package/src/svgriddropdown.async-panel.svelte.test.ts +195 -195
  247. package/src/test-setup.ts +62 -62
  248. package/src/themes/index.ts +288 -288
  249. package/src/toast-store.svelte.ts +250 -250
  250. package/src/toast-store.test.ts +147 -147
  251. package/src/tree-row-model.test.ts +168 -168
  252. package/src/ui-buttons.test.ts +144 -144
  253. package/src/ui-inputs.test.ts +118 -118
  254. package/src/ui-localization.test.ts +113 -113
  255. package/src/ui-range.test.ts +70 -70
  256. package/src/ui-selection.test.ts +155 -155
  257. package/src/ui-tier1.test.ts +142 -142
  258. package/src/virtual.test.ts +88 -88
  259. package/src/virtualization/column-virtualizer.test.ts +27 -27
  260. package/src/virtualization/column-virtualizer.ts +30 -30
  261. package/src/virtualization/svelte-virtualizer.svelte.ts +26 -26
  262. package/src/virtualization/types.ts +30 -30
  263. package/src/virtualization/virtualizer.test.ts +47 -47
  264. package/src/virtualization/virtualizer.ts +322 -322
package/src/SvPopover.svelte CHANGED
@@ -1,197 +1,197 @@
1
- <script lang="ts">
2
- /**
3
- * SvPopover - a floating panel anchored to a trigger, portalled to <body> so it
4
- * escapes any `overflow:hidden` ancestor. Open on click (default), hover, or
5
- * manually via `open`. Positioned by the shared engine (`computePosition`): full
6
- * placement matrix + flip + shift + an optional arrow, kept in sync with
7
- * `autoUpdate`. Closes on outside-click / Escape via the dismissable layer
8
- * stack, and animates in. The panel is hoverable (interactive) under the hover
9
- * trigger. Parity: Smart popover.
10
- *
11
- * ```svelte
12
- * <SvPopover placement="bottom" arrow>
13
- * {#snippet anchor()}<button>Open</button>{/snippet}
14
- * <p>Panel content</p>
15
- * </SvPopover>
16
- * ```
17
- */
18
- import type { Snippet } from 'svelte'
19
- import { portalToBody, popIn } from './popover'
20
- import { computePosition, autoUpdate, type Placement, type ComputePositionResult } from './positioning'
21
- import { createDismissableLayer } from './a11y/dismissable'
22
-
23
- type Props = {
24
- /** Controlled open state (bindable). */
25
- open?: boolean
26
- onOpenChange?: (open: boolean) => void
27
- /** How the anchor opens the panel. `manual` = only `open` drives it. */
28
- trigger?: 'click' | 'hover' | 'manual'
29
- /** Preferred placement (flips when there is no room). Default `bottom-start`. */
30
- placement?: Placement
31
- /** Main-axis gap between trigger and panel. Default 8 (room for the arrow). */
32
- offset?: number
33
- /** Render a pointer arrow toward the trigger. Default true. */
34
- arrow?: boolean
35
- /** Hover trigger: delay (ms) before opening. Default 0. */
36
- openDelay?: number
37
- /** Hover trigger: delay (ms) before closing after leave. Default 120. */
38
- closeDelay?: number
39
- /** Estimated panel height, used before the panel has been measured. */
40
- estimatedHeight?: number
41
- /** Force a minimum panel width (else it hugs its content). */
42
- minWidth?: number
43
- /** Close when clicking outside. Default true. */
44
- closeOnOutsideClick?: boolean
45
- ariaLabel?: string
46
- /** The anchor element(s) that open the panel. */
47
- anchor?: Snippet
48
- /** Panel content. */
49
- children?: Snippet
50
- }
51
-
52
- let {
53
- open = $bindable(false),
54
- onOpenChange,
55
- trigger = 'click',
56
- placement = 'bottom-start',
57
- offset = 8,
58
- arrow = true,
59
- openDelay = 0,
60
- closeDelay = 120,
61
- estimatedHeight = 220,
62
- minWidth,
63
- closeOnOutsideClick = true,
64
- ariaLabel,
65
- anchor,
66
- children,
67
- }: Props = $props()
68
-
69
- const ARROW = 10
70
-
71
- let anchorEl = $state<HTMLSpanElement | null>(null)
72
- let panelEl = $state<HTMLDivElement | null>(null)
73
- let pos = $state<ComputePositionResult>({
74
- x: 0, y: 0, placement, side: 'bottom', align: 'start', maxWidth: 0, maxHeight: 0,
75
- })
76
-
77
- function setOpen(v: boolean) { if (v !== open) { open = v; onOpenChange?.(v) } }
78
- function toggle() { setOpen(!open) }
79
-
80
- function updatePos() {
81
- if (!anchorEl) return
82
- const r = anchorEl.getBoundingClientRect()
83
- const f = panelEl?.getBoundingClientRect()
84
- const floating = {
85
- width: f?.width || minWidth || r.width,
86
- height: f?.height || estimatedHeight,
87
- }
88
- pos = computePosition(
89
- { x: r.left, y: r.top, width: r.width, height: r.height },
90
- floating,
91
- { placement, offset, padding: 8, minMainAxis: 96, arrow: arrow ? { size: ARROW } : undefined },
92
- )
93
- }
94
-
95
- // Reposition whenever the trigger/panel resize or an ancestor scrolls, and wire
96
- // Escape + outside-click dismissal via the shared layer stack (so a popover
97
- // nested in a dialog closes top-first). Re-runs once `panelEl` mounts.
98
- $effect(() => {
99
- if (!open || !anchorEl || !panelEl) return
100
- const stop = autoUpdate(anchorEl, panelEl, updatePos)
101
- const layer = createDismissableLayer({
102
- element: () => [anchorEl, panelEl],
103
- onDismiss: () => setOpen(false),
104
- closeOnOutside: closeOnOutsideClick,
105
- })
106
- layer.activate()
107
- return () => { stop(); layer.release() }
108
- })
109
-
110
- let openTimer: ReturnType<typeof setTimeout> | undefined
111
- let closeTimer: ReturnType<typeof setTimeout> | undefined
112
- function onEnter() {
113
- if (trigger !== 'hover') return
114
- clearTimeout(closeTimer)
115
- if (open) return
116
- openTimer = setTimeout(() => setOpen(true), openDelay)
117
- }
118
- function onLeave() {
119
- if (trigger !== 'hover') return
120
- clearTimeout(openTimer)
121
- closeTimer = setTimeout(() => setOpen(false), closeDelay)
122
- }
123
-
124
- /** Fallback accessible name for the panel when `ariaLabel` isn't given: the
125
- * anchor's own aria-label, else its trimmed text content. */
126
- function anchorFallbackLabel(): string | undefined {
127
- const label = anchorEl?.getAttribute('aria-label')
128
- if (label) return label
129
- return anchorEl?.textContent?.trim() || undefined
130
- }
131
- </script>
132
-
133
- <!-- svelte-ignore a11y_no_static_element_interactions -->
134
- <span
135
- bind:this={anchorEl}
136
- class="sv-pop__anchor"
137
- onclick={() => trigger === 'click' && toggle()}
138
- onpointerenter={onEnter}
139
- onpointerleave={onLeave}
140
- onfocusin={onEnter}
141
- onfocusout={onLeave}
142
- >
143
- {@render anchor?.()}
144
- </span>
145
-
146
- {#if open}
147
- <div
148
- bind:this={panelEl}
149
- class="sv-pop__panel"
150
- use:portalToBody
151
- use:popIn={{ up: pos.side === 'top' }}
152
- style:position="fixed"
153
- style:top={`${pos.y}px`}
154
- style:left={`${pos.x}px`}
155
- style:min-width={minWidth ? `${minWidth}px` : undefined}
156
- role="dialog"
157
- aria-label={ariaLabel ?? anchorFallbackLabel()}
158
- onpointerenter={onEnter}
159
- onpointerleave={onLeave}
160
- onfocusin={onEnter}
161
- onfocusout={onLeave}
162
- >
163
- {#if arrow}
164
- <span
165
- class="sv-pop__arrow sv-pop__arrow--{pos.side}"
166
- style:left={pos.arrow?.x != null ? `${pos.arrow.x}px` : undefined}
167
- style:top={pos.arrow?.y != null ? `${pos.arrow.y}px` : undefined}
168
- ></span>
169
- {/if}
170
- <div class="sv-pop__content" style:max-height={pos.maxHeight ? `${pos.maxHeight}px` : undefined}>
171
- {@render children?.()}
172
- </div>
173
- </div>
174
- {/if}
175
-
176
- <style>
177
- .sv-pop__anchor { display: inline-flex; }
178
- :global(.sv-pop__panel) {
179
- z-index: 2147483646; max-width: min(92vw, 360px);
180
- background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a);
181
- border: 1px solid var(--sg-border, #e2e8f0); border-radius: 10px;
182
- box-shadow: 0 16px 48px -12px rgba(15, 23, 42, 0.35); font-size: 13px; line-height: 1.55;
183
- }
184
- :global(.sv-pop__content) { padding: 12px 14px; overflow: auto; }
185
- /* Arrow: a rotated square straddling the panel edge, two borders showing so it
186
- reads as a continuation of the panel outline. Not clipped (sibling of the
187
- scrollable content, panel itself has no overflow). */
188
- :global(.sv-pop__arrow) {
189
- position: absolute; width: 10px; height: 10px;
190
- background: var(--sg-bg, #fff); border: 1px solid var(--sg-border, #e2e8f0);
191
- transform: rotate(45deg);
192
- }
193
- :global(.sv-pop__arrow--bottom) { top: -6px; border-right: 0; border-bottom: 0; }
194
- :global(.sv-pop__arrow--top) { bottom: -6px; border-left: 0; border-top: 0; }
195
- :global(.sv-pop__arrow--right) { left: -6px; border-top: 0; border-right: 0; }
196
- :global(.sv-pop__arrow--left) { right: -6px; border-bottom: 0; border-left: 0; }
197
- </style>
1
+ <script lang="ts">
2
+ /**
3
+ * SvPopover - a floating panel anchored to a trigger, portalled to <body> so it
4
+ * escapes any `overflow:hidden` ancestor. Open on click (default), hover, or
5
+ * manually via `open`. Positioned by the shared engine (`computePosition`): full
6
+ * placement matrix + flip + shift + an optional arrow, kept in sync with
7
+ * `autoUpdate`. Closes on outside-click / Escape via the dismissable layer
8
+ * stack, and animates in. The panel is hoverable (interactive) under the hover
9
+ * trigger. Parity: Smart popover.
10
+ *
11
+ * ```svelte
12
+ * <SvPopover placement="bottom" arrow>
13
+ * {#snippet anchor()}<button>Open</button>{/snippet}
14
+ * <p>Panel content</p>
15
+ * </SvPopover>
16
+ * ```
17
+ */
18
+ import type { Snippet } from 'svelte'
19
+ import { portalToBody, popIn } from './popover'
20
+ import { computePosition, autoUpdate, type Placement, type ComputePositionResult } from './positioning'
21
+ import { createDismissableLayer } from './a11y/dismissable'
22
+
23
+ type Props = {
24
+ /** Controlled open state (bindable). */
25
+ open?: boolean
26
+ onOpenChange?: (open: boolean) => void
27
+ /** How the anchor opens the panel. `manual` = only `open` drives it. */
28
+ trigger?: 'click' | 'hover' | 'manual'
29
+ /** Preferred placement (flips when there is no room). Default `bottom-start`. */
30
+ placement?: Placement
31
+ /** Main-axis gap between trigger and panel. Default 8 (room for the arrow). */
32
+ offset?: number
33
+ /** Render a pointer arrow toward the trigger. Default true. */
34
+ arrow?: boolean
35
+ /** Hover trigger: delay (ms) before opening. Default 0. */
36
+ openDelay?: number
37
+ /** Hover trigger: delay (ms) before closing after leave. Default 120. */
38
+ closeDelay?: number
39
+ /** Estimated panel height, used before the panel has been measured. */
40
+ estimatedHeight?: number
41
+ /** Force a minimum panel width (else it hugs its content). */
42
+ minWidth?: number
43
+ /** Close when clicking outside. Default true. */
44
+ closeOnOutsideClick?: boolean
45
+ ariaLabel?: string
46
+ /** The anchor element(s) that open the panel. */
47
+ anchor?: Snippet
48
+ /** Panel content. */
49
+ children?: Snippet
50
+ }
51
+
52
+ let {
53
+ open = $bindable(false),
54
+ onOpenChange,
55
+ trigger = 'click',
56
+ placement = 'bottom-start',
57
+ offset = 8,
58
+ arrow = true,
59
+ openDelay = 0,
60
+ closeDelay = 120,
61
+ estimatedHeight = 220,
62
+ minWidth,
63
+ closeOnOutsideClick = true,
64
+ ariaLabel,
65
+ anchor,
66
+ children,
67
+ }: Props = $props()
68
+
69
+ const ARROW = 10
70
+
71
+ let anchorEl = $state<HTMLSpanElement | null>(null)
72
+ let panelEl = $state<HTMLDivElement | null>(null)
73
+ let pos = $state<ComputePositionResult>({
74
+ x: 0, y: 0, placement, side: 'bottom', align: 'start', maxWidth: 0, maxHeight: 0,
75
+ })
76
+
77
+ function setOpen(v: boolean) { if (v !== open) { open = v; onOpenChange?.(v) } }
78
+ function toggle() { setOpen(!open) }
79
+
80
+ function updatePos() {
81
+ if (!anchorEl) return
82
+ const r = anchorEl.getBoundingClientRect()
83
+ const f = panelEl?.getBoundingClientRect()
84
+ const floating = {
85
+ width: f?.width || minWidth || r.width,
86
+ height: f?.height || estimatedHeight,
87
+ }
88
+ pos = computePosition(
89
+ { x: r.left, y: r.top, width: r.width, height: r.height },
90
+ floating,
91
+ { placement, offset, padding: 8, minMainAxis: 96, arrow: arrow ? { size: ARROW } : undefined },
92
+ )
93
+ }
94
+
95
+ // Reposition whenever the trigger/panel resize or an ancestor scrolls, and wire
96
+ // Escape + outside-click dismissal via the shared layer stack (so a popover
97
+ // nested in a dialog closes top-first). Re-runs once `panelEl` mounts.
98
+ $effect(() => {
99
+ if (!open || !anchorEl || !panelEl) return
100
+ const stop = autoUpdate(anchorEl, panelEl, updatePos)
101
+ const layer = createDismissableLayer({
102
+ element: () => [anchorEl, panelEl],
103
+ onDismiss: () => setOpen(false),
104
+ closeOnOutside: closeOnOutsideClick,
105
+ })
106
+ layer.activate()
107
+ return () => { stop(); layer.release() }
108
+ })
109
+
110
+ let openTimer: ReturnType<typeof setTimeout> | undefined
111
+ let closeTimer: ReturnType<typeof setTimeout> | undefined
112
+ function onEnter() {
113
+ if (trigger !== 'hover') return
114
+ clearTimeout(closeTimer)
115
+ if (open) return
116
+ openTimer = setTimeout(() => setOpen(true), openDelay)
117
+ }
118
+ function onLeave() {
119
+ if (trigger !== 'hover') return
120
+ clearTimeout(openTimer)
121
+ closeTimer = setTimeout(() => setOpen(false), closeDelay)
122
+ }
123
+
124
+ /** Fallback accessible name for the panel when `ariaLabel` isn't given: the
125
+ * anchor's own aria-label, else its trimmed text content. */
126
+ function anchorFallbackLabel(): string | undefined {
127
+ const label = anchorEl?.getAttribute('aria-label')
128
+ if (label) return label
129
+ return anchorEl?.textContent?.trim() || undefined
130
+ }
131
+ </script>
132
+
133
+ <!-- svelte-ignore a11y_no_static_element_interactions -->
134
+ <span
135
+ bind:this={anchorEl}
136
+ class="sv-pop__anchor"
137
+ onclick={() => trigger === 'click' && toggle()}
138
+ onpointerenter={onEnter}
139
+ onpointerleave={onLeave}
140
+ onfocusin={onEnter}
141
+ onfocusout={onLeave}
142
+ >
143
+ {@render anchor?.()}
144
+ </span>
145
+
146
+ {#if open}
147
+ <div
148
+ bind:this={panelEl}
149
+ class="sv-pop__panel"
150
+ use:portalToBody
151
+ use:popIn={{ up: pos.side === 'top' }}
152
+ style:position="fixed"
153
+ style:top={`${pos.y}px`}
154
+ style:left={`${pos.x}px`}
155
+ style:min-width={minWidth ? `${minWidth}px` : undefined}
156
+ role="dialog"
157
+ aria-label={ariaLabel ?? anchorFallbackLabel()}
158
+ onpointerenter={onEnter}
159
+ onpointerleave={onLeave}
160
+ onfocusin={onEnter}
161
+ onfocusout={onLeave}
162
+ >
163
+ {#if arrow}
164
+ <span
165
+ class="sv-pop__arrow sv-pop__arrow--{pos.side}"
166
+ style:left={pos.arrow?.x != null ? `${pos.arrow.x}px` : undefined}
167
+ style:top={pos.arrow?.y != null ? `${pos.arrow.y}px` : undefined}
168
+ ></span>
169
+ {/if}
170
+ <div class="sv-pop__content" style:max-height={pos.maxHeight ? `${pos.maxHeight}px` : undefined}>
171
+ {@render children?.()}
172
+ </div>
173
+ </div>
174
+ {/if}
175
+
176
+ <style>
177
+ .sv-pop__anchor { display: inline-flex; }
178
+ :global(.sv-pop__panel) {
179
+ z-index: 2147483646; max-width: min(92vw, 360px);
180
+ background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a);
181
+ border: 1px solid var(--sg-border, #e2e8f0); border-radius: 10px;
182
+ box-shadow: 0 16px 48px -12px rgba(15, 23, 42, 0.35); font-size: 13px; line-height: 1.55;
183
+ }
184
+ :global(.sv-pop__content) { padding: 12px 14px; overflow: auto; }
185
+ /* Arrow: a rotated square straddling the panel edge, two borders showing so it
186
+ reads as a continuation of the panel outline. Not clipped (sibling of the
187
+ scrollable content, panel itself has no overflow). */
188
+ :global(.sv-pop__arrow) {
189
+ position: absolute; width: 10px; height: 10px;
190
+ background: var(--sg-bg, #fff); border: 1px solid var(--sg-border, #e2e8f0);
191
+ transform: rotate(45deg);
192
+ }
193
+ :global(.sv-pop__arrow--bottom) { top: -6px; border-right: 0; border-bottom: 0; }
194
+ :global(.sv-pop__arrow--top) { bottom: -6px; border-left: 0; border-top: 0; }
195
+ :global(.sv-pop__arrow--right) { left: -6px; border-top: 0; border-right: 0; }
196
+ :global(.sv-pop__arrow--left) { right: -6px; border-bottom: 0; border-left: 0; }
197
+ </style>
package/src/SvProgress.svelte CHANGED
@@ -1,116 +1,116 @@
1
- <script lang="ts">
2
- /**
3
- * SvProgress - a linear progress bar (WAI-ARIA `progressbar`). Determinate
4
- * (value/max) or `indeterminate` (animated), with color intents, sizes, an
5
- * optional label and an optional secondary `buffer` track. Theme-driven via
6
- * `--sg-*`; respects prefers-reduced-motion. Parity: Smart progress bar.
7
- *
8
- * ```svelte
9
- * <SvProgress value={64} showLabel />
10
- * <SvProgress indeterminate color="success" />
11
- * ```
12
- */
13
- type Props = {
14
- /** Current value (0..max). Ignored when `indeterminate`. */
15
- value?: number
16
- max?: number
17
- /** Unknown-duration animated bar. */
18
- indeterminate?: boolean
19
- /** Buffered/secondary value (e.g. streamed-ahead), 0..max. */
20
- buffer?: number
21
- color?: 'accent' | 'success' | 'warning' | 'danger'
22
- size?: 'sm' | 'md' | 'lg'
23
- /** Show a percentage label at the end of the bar. */
24
- showLabel?: boolean
25
- /** Format the label (default: rounded percent). */
26
- formatLabel?: (value: number, max: number) => string
27
- /** Diagonal candy-stripe overlay on the fill. */
28
- striped?: boolean
29
- ariaLabel?: string
30
- }
31
-
32
- let {
33
- value = 0,
34
- max = 100,
35
- indeterminate = false,
36
- buffer,
37
- color = 'accent',
38
- size = 'md',
39
- showLabel = false,
40
- formatLabel,
41
- striped = false,
42
- ariaLabel,
43
- }: Props = $props()
44
-
45
- const pct = $derived(max > 0 ? Math.min(100, Math.max(0, (value / max) * 100)) : 0)
46
- const bufPct = $derived(buffer != null && max > 0 ? Math.min(100, Math.max(0, (buffer / max) * 100)) : null)
47
- const label = $derived(formatLabel ? formatLabel(value, max) : `${Math.round(pct)}%`)
48
- </script>
49
-
50
- <div class="sv-prog sv-prog--{size} sv-prog--{color}" class:has-label={showLabel && !indeterminate}>
51
- <div
52
- class="sv-prog__track"
53
- role="progressbar"
54
- aria-label={ariaLabel}
55
- aria-valuemin={indeterminate ? undefined : 0}
56
- aria-valuemax={indeterminate ? undefined : max}
57
- aria-valuenow={indeterminate ? undefined : value}
58
- aria-valuetext={indeterminate ? undefined : label}
59
- >
60
- {#if bufPct != null && !indeterminate}<div class="sv-prog__buffer" style:width={`${bufPct}%`}></div>{/if}
61
- <div
62
- class="sv-prog__fill"
63
- class:is-indeterminate={indeterminate}
64
- class:is-striped={striped}
65
- style:width={indeterminate ? undefined : `${pct}%`}
66
- ></div>
67
- </div>
68
- {#if showLabel && !indeterminate}<span class="sv-prog__label">{label}</span>{/if}
69
- </div>
70
-
71
- <style>
72
- .sv-prog {
73
- --_accent: var(--sg-accent, #2563eb);
74
- --_c: var(--_accent);
75
- display: flex; align-items: center; gap: 10px; width: 100%;
76
- }
77
- .sv-prog--success { --_c: var(--sg-success, #16a34a); }
78
- .sv-prog--warning { --_c: var(--sg-warning, #d97706); }
79
- .sv-prog--danger { --_c: var(--sg-danger, #dc2626); }
80
- .sv-prog__track {
81
- position: relative; flex: 1; overflow: hidden;
82
- background: var(--sg-border, #e2e8f0); border-radius: 999px;
83
- }
84
- .sv-prog--sm .sv-prog__track { height: 5px; }
85
- .sv-prog--md .sv-prog__track { height: 8px; }
86
- .sv-prog--lg .sv-prog__track { height: 12px; }
87
- .sv-prog__buffer {
88
- position: absolute; inset-block: 0; inset-inline-start: 0;
89
- background: color-mix(in srgb, var(--_c) 28%, transparent); border-radius: 999px;
90
- }
91
- .sv-prog__fill {
92
- position: absolute; inset-block: 0; inset-inline-start: 0; min-width: 0;
93
- background: var(--_c); border-radius: 999px; transition: width 0.3s cubic-bezier(0.16, 1, 0.3, 1);
94
- }
95
- .sv-prog__fill.is-striped {
96
- background-image: linear-gradient(45deg, rgba(255,255,255,0.22) 25%, transparent 25%, transparent 50%, rgba(255,255,255,0.22) 50%, rgba(255,255,255,0.22) 75%, transparent 75%);
97
- background-size: 16px 16px; animation: sv-prog-stripe 0.8s linear infinite;
98
- }
99
- .sv-prog__fill.is-indeterminate {
100
- width: 40%; border-radius: 999px;
101
- animation: sv-prog-indet 1.3s cubic-bezier(0.65, 0.05, 0.36, 1) infinite;
102
- }
103
- @keyframes sv-prog-indet {
104
- 0% { inset-inline-start: -45%; } 100% { inset-inline-start: 100%; }
105
- }
106
- @keyframes sv-prog-stripe { to { background-position: 16px 0; } }
107
- @media (prefers-reduced-motion: reduce) {
108
- .sv-prog__fill.is-indeterminate { animation-duration: 2.4s; }
109
- .sv-prog__fill.is-striped { animation: none; }
110
- .sv-prog__fill { transition: none; }
111
- }
112
- .sv-prog__label {
113
- flex: none; min-width: 38px; text-align: end; font-size: 12px; font-weight: 600;
114
- font-variant-numeric: tabular-nums; color: var(--sg-muted, #64748b);
115
- }
116
- </style>
1
+ <script lang="ts">
2
+ /**
3
+ * SvProgress - a linear progress bar (WAI-ARIA `progressbar`). Determinate
4
+ * (value/max) or `indeterminate` (animated), with color intents, sizes, an
5
+ * optional label and an optional secondary `buffer` track. Theme-driven via
6
+ * `--sg-*`; respects prefers-reduced-motion. Parity: Smart progress bar.
7
+ *
8
+ * ```svelte
9
+ * <SvProgress value={64} showLabel />
10
+ * <SvProgress indeterminate color="success" />
11
+ * ```
12
+ */
13
+ type Props = {
14
+ /** Current value (0..max). Ignored when `indeterminate`. */
15
+ value?: number
16
+ max?: number
17
+ /** Unknown-duration animated bar. */
18
+ indeterminate?: boolean
19
+ /** Buffered/secondary value (e.g. streamed-ahead), 0..max. */
20
+ buffer?: number
21
+ color?: 'accent' | 'success' | 'warning' | 'danger'
22
+ size?: 'sm' | 'md' | 'lg'
23
+ /** Show a percentage label at the end of the bar. */
24
+ showLabel?: boolean
25
+ /** Format the label (default: rounded percent). */
26
+ formatLabel?: (value: number, max: number) => string
27
+ /** Diagonal candy-stripe overlay on the fill. */
28
+ striped?: boolean
29
+ ariaLabel?: string
30
+ }
31
+
32
+ let {
33
+ value = 0,
34
+ max = 100,
35
+ indeterminate = false,
36
+ buffer,
37
+ color = 'accent',
38
+ size = 'md',
39
+ showLabel = false,
40
+ formatLabel,
41
+ striped = false,
42
+ ariaLabel,
43
+ }: Props = $props()
44
+
45
+ const pct = $derived(max > 0 ? Math.min(100, Math.max(0, (value / max) * 100)) : 0)
46
+ const bufPct = $derived(buffer != null && max > 0 ? Math.min(100, Math.max(0, (buffer / max) * 100)) : null)
47
+ const label = $derived(formatLabel ? formatLabel(value, max) : `${Math.round(pct)}%`)
48
+ </script>
49
+
50
+ <div class="sv-prog sv-prog--{size} sv-prog--{color}" class:has-label={showLabel && !indeterminate}>
51
+ <div
52
+ class="sv-prog__track"
53
+ role="progressbar"
54
+ aria-label={ariaLabel}
55
+ aria-valuemin={indeterminate ? undefined : 0}
56
+ aria-valuemax={indeterminate ? undefined : max}
57
+ aria-valuenow={indeterminate ? undefined : value}
58
+ aria-valuetext={indeterminate ? undefined : label}
59
+ >
60
+ {#if bufPct != null && !indeterminate}<div class="sv-prog__buffer" style:width={`${bufPct}%`}></div>{/if}
61
+ <div
62
+ class="sv-prog__fill"
63
+ class:is-indeterminate={indeterminate}
64
+ class:is-striped={striped}
65
+ style:width={indeterminate ? undefined : `${pct}%`}
66
+ ></div>
67
+ </div>
68
+ {#if showLabel && !indeterminate}<span class="sv-prog__label">{label}</span>{/if}
69
+ </div>
70
+
71
+ <style>
72
+ .sv-prog {
73
+ --_accent: var(--sg-accent, #2563eb);
74
+ --_c: var(--_accent);
75
+ display: flex; align-items: center; gap: 10px; width: 100%;
76
+ }
77
+ .sv-prog--success { --_c: var(--sg-success, #16a34a); }
78
+ .sv-prog--warning { --_c: var(--sg-warning, #d97706); }
79
+ .sv-prog--danger { --_c: var(--sg-danger, #dc2626); }
80
+ .sv-prog__track {
81
+ position: relative; flex: 1; overflow: hidden;
82
+ background: var(--sg-border, #e2e8f0); border-radius: 999px;
83
+ }
84
+ .sv-prog--sm .sv-prog__track { height: 5px; }
85
+ .sv-prog--md .sv-prog__track { height: 8px; }
86
+ .sv-prog--lg .sv-prog__track { height: 12px; }
87
+ .sv-prog__buffer {
88
+ position: absolute; inset-block: 0; inset-inline-start: 0;
89
+ background: color-mix(in srgb, var(--_c) 28%, transparent); border-radius: 999px;
90
+ }
91
+ .sv-prog__fill {
92
+ position: absolute; inset-block: 0; inset-inline-start: 0; min-width: 0;
93
+ background: var(--_c); border-radius: 999px; transition: width 0.3s cubic-bezier(0.16, 1, 0.3, 1);
94
+ }
95
+ .sv-prog__fill.is-striped {
96
+ background-image: linear-gradient(45deg, rgba(255,255,255,0.22) 25%, transparent 25%, transparent 50%, rgba(255,255,255,0.22) 50%, rgba(255,255,255,0.22) 75%, transparent 75%);
97
+ background-size: 16px 16px; animation: sv-prog-stripe 0.8s linear infinite;
98
+ }
99
+ .sv-prog__fill.is-indeterminate {
100
+ width: 40%; border-radius: 999px;
101
+ animation: sv-prog-indet 1.3s cubic-bezier(0.65, 0.05, 0.36, 1) infinite;
102
+ }
103
+ @keyframes sv-prog-indet {
104
+ 0% { inset-inline-start: -45%; } 100% { inset-inline-start: 100%; }
105
+ }
106
+ @keyframes sv-prog-stripe { to { background-position: 16px 0; } }
107
+ @media (prefers-reduced-motion: reduce) {
108
+ .sv-prog__fill.is-indeterminate { animation-duration: 2.4s; }
109
+ .sv-prog__fill.is-striped { animation: none; }
110
+ .sv-prog__fill { transition: none; }
111
+ }
112
+ .sv-prog__label {
113
+ flex: none; min-width: 38px; text-align: end; font-size: 12px; font-weight: 600;
114
+ font-variant-numeric: tabular-nums; color: var(--sg-muted, #64748b);
115
+ }
116
+ </style>