@svgrid/grid 2.6.17 → 2.6.19

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,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>
@@ -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>