@svgrid/grid 2.1.22 → 2.2.0

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 (295) 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/FlexRender.svelte +96 -96
  7. package/dist/GridFooter.svelte +178 -178
  8. package/dist/GridMenus.svelte +83 -3
  9. package/dist/SvAutoComplete.svelte +5 -3
  10. package/dist/SvCarousel.svelte +141 -163
  11. package/dist/SvColorInput.svelte +187 -186
  12. package/dist/SvColorInput.svelte.d.ts +1 -1
  13. package/dist/SvComboBox.svelte +7 -3
  14. package/dist/SvCommand.svelte +28 -85
  15. package/dist/SvContextMenu.svelte +116 -116
  16. package/dist/SvCountryInput.svelte +1 -1
  17. package/dist/SvDateRangeInput.svelte +1 -1
  18. package/dist/SvDateTimePicker.svelte +9 -3
  19. package/dist/SvDateTimePicker.svelte.d.ts +3 -0
  20. package/dist/SvDockLayout.svelte +244 -0
  21. package/dist/SvDockLayout.svelte.d.ts +77 -0
  22. package/dist/SvDockManager.svelte +922 -0
  23. package/dist/SvDockManager.svelte.d.ts +106 -0
  24. package/dist/SvDrawer.svelte +250 -228
  25. package/dist/SvDrawer.svelte.d.ts +4 -0
  26. package/dist/SvDropDownList.svelte +85 -13
  27. package/dist/SvDropDownList.svelte.d.ts +3 -0
  28. package/dist/SvField.svelte +21 -4
  29. package/dist/SvField.svelte.d.ts +1 -0
  30. package/dist/SvForm.svelte +201 -91
  31. package/dist/SvForm.svelte.d.ts +15 -22
  32. package/dist/SvGrid.controller.svelte.d.ts +32 -1
  33. package/dist/SvGrid.controller.svelte.js +156 -27
  34. package/dist/SvGrid.css +193 -5
  35. package/dist/SvGrid.svelte +3131 -2786
  36. package/dist/SvGrid.types.d.ts +452 -1
  37. package/dist/SvGridBoard.svelte +2339 -2339
  38. package/dist/SvGridChart.svelte +1724 -1724
  39. package/dist/SvGridChartPanel.svelte +485 -485
  40. package/dist/SvGridDropdown.svelte +689 -682
  41. package/dist/SvGridSelect.svelte +1 -0
  42. package/dist/SvGroupCell.svelte +109 -109
  43. package/dist/SvListBox.svelte +36 -14
  44. package/dist/SvMaskedInput.svelte +4 -3
  45. package/dist/SvMaskedInput.svelte.d.ts +1 -1
  46. package/dist/SvMenu.svelte +124 -124
  47. package/dist/SvMenuList.svelte +117 -165
  48. package/dist/SvMenuList.svelte.d.ts +2 -13
  49. package/dist/SvModal.svelte +12 -29
  50. package/dist/SvMultiSelect.svelte +1 -0
  51. package/dist/SvNumberInput.svelte +131 -130
  52. package/dist/SvNumberInput.svelte.d.ts +1 -1
  53. package/dist/SvOtpInput.svelte +158 -158
  54. package/dist/SvPagination.svelte +18 -18
  55. package/dist/SvPasswordInput.svelte +3 -2
  56. package/dist/SvPasswordInput.svelte.d.ts +1 -1
  57. package/dist/SvPhoneInput.svelte +3 -2
  58. package/dist/SvPhoneInput.svelte.d.ts +1 -1
  59. package/dist/SvPopover.svelte +139 -139
  60. package/dist/SvRowGroupPanel.svelte +170 -170
  61. package/dist/SvScrollArea.svelte +61 -61
  62. package/dist/SvStepper.svelte +6 -9
  63. package/dist/SvTagsInput.svelte +3 -2
  64. package/dist/SvTagsInput.svelte.d.ts +1 -1
  65. package/dist/SvTooltip.svelte +127 -138
  66. package/dist/SvTour.svelte +204 -176
  67. package/dist/SvTree.svelte +377 -377
  68. package/dist/SvTreeSelect.svelte +230 -229
  69. package/dist/build-api.js +76 -54
  70. package/dist/cdn/svgrid.js +10913 -6450
  71. package/dist/cdn/svgrid.svelte-external.js +9628 -5481
  72. package/dist/chart-export.js +8 -8
  73. package/dist/columns.js +6 -0
  74. package/dist/conditional-formatting.d.ts +67 -3
  75. package/dist/conditional-formatting.js +124 -17
  76. package/dist/createCarousel.svelte.d.ts +72 -0
  77. package/dist/createCarousel.svelte.js +80 -0
  78. package/dist/createCommand.svelte.d.ts +62 -0
  79. package/dist/createCommand.svelte.js +109 -0
  80. package/dist/createForm.svelte.d.ts +62 -0
  81. package/dist/createForm.svelte.js +374 -0
  82. package/dist/createMenu.svelte.d.ts +88 -0
  83. package/dist/createMenu.svelte.js +153 -0
  84. package/dist/createOverlay.svelte.d.ts +38 -0
  85. package/dist/createOverlay.svelte.js +68 -0
  86. package/dist/createPagination.d.ts +74 -0
  87. package/dist/createPagination.js +71 -0
  88. package/dist/createPopoverSelect.svelte.js +6 -12
  89. package/dist/createStepper.d.ts +44 -0
  90. package/dist/createStepper.js +26 -0
  91. package/dist/createTooltip.svelte.d.ts +32 -0
  92. package/dist/createTooltip.svelte.js +61 -0
  93. package/dist/datetime/timezone.d.ts +36 -0
  94. package/dist/datetime/timezone.js +110 -0
  95. package/dist/dock-context.d.ts +52 -0
  96. package/dist/dock-context.js +1 -0
  97. package/dist/dock-manager-model.d.ts +136 -0
  98. package/dist/dock-manager-model.js +514 -0
  99. package/dist/dock-model.d.ts +105 -0
  100. package/dist/dock-model.js +288 -0
  101. package/dist/dock-popout.d.ts +30 -0
  102. package/dist/dock-popout.js +81 -0
  103. package/dist/editor-contract.d.ts +2 -0
  104. package/dist/filter-operators.d.ts +6 -0
  105. package/dist/filter-operators.js +35 -2
  106. package/dist/filtering/excel-filters.d.ts +18 -1
  107. package/dist/filtering/excel-filters.js +56 -0
  108. package/dist/form-field.d.ts +73 -0
  109. package/dist/form-field.js +15 -0
  110. package/dist/index.d.ts +25 -5
  111. package/dist/index.js +40 -4
  112. package/dist/list-nav.d.ts +18 -0
  113. package/dist/list-nav.js +30 -0
  114. package/dist/list-option.d.ts +2 -0
  115. package/dist/menu-item.d.ts +20 -0
  116. package/dist/menu-item.js +1 -0
  117. package/dist/menus.d.ts +5 -0
  118. package/dist/menus.js +68 -16
  119. package/dist/panel-resize.d.ts +25 -0
  120. package/dist/panel-resize.js +40 -0
  121. package/dist/popover.d.ts +29 -3
  122. package/dist/popover.js +22 -6
  123. package/dist/recurrence.d.ts +33 -7
  124. package/dist/recurrence.js +151 -13
  125. package/dist/row-drag.d.ts +8 -0
  126. package/dist/row-drag.js +11 -0
  127. package/dist/scheduler-ical.d.ts +30 -0
  128. package/dist/scheduler-ical.js +180 -0
  129. package/dist/scheduler-model.d.ts +269 -0
  130. package/dist/scheduler-model.js +602 -0
  131. package/dist/scheduler-view.svelte.d.ts +22 -0
  132. package/dist/scheduler-view.svelte.js +13 -0
  133. package/dist/spreadsheet.js +20 -12
  134. package/dist/ui-app.types.d.ts +3 -0
  135. package/package.json +14 -10
  136. package/src/DockNodeView.svelte +306 -0
  137. package/src/DockPopoutHost.svelte +17 -0
  138. package/src/FlexRender.svelte +96 -96
  139. package/src/GridFooter.svelte +178 -178
  140. package/src/GridMenus.svelte +83 -3
  141. package/src/SvAutoComplete.svelte +5 -3
  142. package/src/SvCarousel.svelte +141 -163
  143. package/src/SvCarousel.test.ts +68 -0
  144. package/src/SvColorInput.svelte +187 -186
  145. package/src/SvComboBox.svelte +7 -3
  146. package/src/SvCommand.svelte +28 -85
  147. package/src/SvCommand.test.ts +78 -0
  148. package/src/SvContextMenu.svelte +116 -116
  149. package/src/SvCountryInput.svelte +1 -1
  150. package/src/SvDateRangeInput.svelte +1 -1
  151. package/src/SvDateTimePicker.svelte +9 -3
  152. package/src/SvDockLayout.svelte +244 -0
  153. package/src/SvDockManager.svelte +922 -0
  154. package/src/SvDrawer.svelte +250 -228
  155. package/src/SvDropDownList.svelte +85 -13
  156. package/src/SvField.svelte +21 -4
  157. package/src/SvForm.svelte +201 -91
  158. package/src/SvForm.test.ts +299 -0
  159. package/src/SvGrid.controller.svelte.ts +3158 -3034
  160. package/src/SvGrid.css +193 -5
  161. package/src/SvGrid.svelte +3131 -2786
  162. package/src/SvGrid.types.ts +1489 -1027
  163. package/src/SvGridBoard.svelte +2339 -2339
  164. package/src/SvGridChart.svelte +1724 -1724
  165. package/src/SvGridChartPanel.svelte +485 -485
  166. package/src/SvGridDropdown.svelte +689 -682
  167. package/src/SvGridSelect.svelte +1 -0
  168. package/src/SvGroupCell.svelte +109 -109
  169. package/src/SvListBox.svelte +36 -14
  170. package/src/SvMaskedInput.svelte +4 -3
  171. package/src/SvMenu.svelte +124 -124
  172. package/src/SvMenu.test.ts +97 -73
  173. package/src/SvMenuList.svelte +117 -165
  174. package/src/SvModal.svelte +12 -29
  175. package/src/SvModal.test.ts +82 -0
  176. package/src/SvMultiSelect.svelte +1 -0
  177. package/src/SvNumberInput.svelte +131 -130
  178. package/src/SvOtpInput.svelte +158 -158
  179. package/src/SvPagination.svelte +18 -18
  180. package/src/SvPasswordInput.svelte +3 -2
  181. package/src/SvPhoneInput.svelte +3 -2
  182. package/src/SvPopover.svelte +139 -139
  183. package/src/SvRowGroupPanel.svelte +170 -170
  184. package/src/SvScrollArea.svelte +61 -61
  185. package/src/SvStepper.svelte +6 -9
  186. package/src/SvTagsInput.svelte +3 -2
  187. package/src/SvTooltip.svelte +127 -138
  188. package/src/SvTooltip.test.ts +73 -0
  189. package/src/SvTour.svelte +204 -176
  190. package/src/SvTree.svelte +377 -377
  191. package/src/SvTreeSelect.svelte +230 -229
  192. package/src/a11y.contract.test.ts +49 -49
  193. package/src/a11y.test.ts +59 -59
  194. package/src/a11y.ts +61 -61
  195. package/src/build-api.ts +870 -847
  196. package/src/cell-formatting.ts +169 -169
  197. package/src/cell-render.ts +469 -469
  198. package/src/chart-export.ts +201 -201
  199. package/src/chart.ts +2296 -2296
  200. package/src/collaboration.test.ts +104 -104
  201. package/src/collaboration.ts +167 -167
  202. package/src/columns.ts +5 -0
  203. package/src/conditional-formatting.test.ts +104 -0
  204. package/src/conditional-formatting.ts +176 -19
  205. package/src/core.performance.test.ts +30 -30
  206. package/src/core.ts +1111 -1111
  207. package/src/createAutocomplete.svelte.ts +132 -132
  208. package/src/createCarousel.svelte.ts +104 -0
  209. package/src/createCombobox.svelte.ts +179 -179
  210. package/src/createCommand.svelte.ts +125 -0
  211. package/src/createCountryInput.svelte.ts +157 -157
  212. package/src/createDropdownList.svelte.ts +162 -162
  213. package/src/createForm.svelte.ts +333 -0
  214. package/src/createGrid.svelte.ts +42 -42
  215. package/src/createGrid.test.ts +10 -10
  216. package/src/createGridState.svelte.ts +17 -17
  217. package/src/createMenu.svelte.ts +202 -0
  218. package/src/createOverlay.svelte.ts +101 -0
  219. package/src/createPagination.test.ts +65 -0
  220. package/src/createPagination.ts +84 -0
  221. package/src/createPopoverSelect.svelte.ts +206 -210
  222. package/src/createStepper.test.ts +62 -0
  223. package/src/createStepper.ts +61 -0
  224. package/src/createTooltip.svelte.ts +86 -0
  225. package/src/createTree.svelte.ts +319 -319
  226. package/src/datetime/timezone.test.ts +69 -0
  227. package/src/datetime/timezone.ts +134 -0
  228. package/src/dock-context.ts +47 -0
  229. package/src/dock-manager-model.test.ts +275 -0
  230. package/src/dock-manager-model.ts +593 -0
  231. package/src/dock-model.test.ts +163 -0
  232. package/src/dock-model.ts +368 -0
  233. package/src/dock-popout.ts +94 -0
  234. package/src/editing.test.ts +859 -859
  235. package/src/editing.ts +675 -675
  236. package/src/editor-contract.ts +2 -0
  237. package/src/export-data-api.test.ts +126 -126
  238. package/src/export-format.test.ts +107 -107
  239. package/src/export-format.ts +598 -598
  240. package/src/filter-operators.test.ts +59 -0
  241. package/src/filter-operators.ts +35 -2
  242. package/src/filtering/excel-filters.test.ts +86 -1
  243. package/src/filtering/excel-filters.ts +65 -0
  244. package/src/flex-render.ts +3 -3
  245. package/src/form-field.ts +87 -0
  246. package/src/index.ts +623 -469
  247. package/src/keyboard.test.ts +59 -59
  248. package/src/keyboard.ts +97 -97
  249. package/src/list-nav.test.ts +49 -0
  250. package/src/list-nav.ts +29 -0
  251. package/src/list-option.ts +2 -0
  252. package/src/menu-item.ts +21 -0
  253. package/src/menus.test.ts +48 -0
  254. package/src/menus.ts +639 -582
  255. package/src/merge-objects.ts +48 -48
  256. package/src/overlays.test.ts +90 -90
  257. package/src/panel-resize.ts +52 -0
  258. package/src/popover.bounds.test.ts +93 -0
  259. package/src/popover.ts +51 -7
  260. package/src/recurrence.test.ts +88 -1
  261. package/src/recurrence.ts +166 -15
  262. package/src/render-component.ts +28 -28
  263. package/src/row-drag.ts +10 -0
  264. package/src/scheduler-ical.test.ts +68 -0
  265. package/src/scheduler-ical.ts +180 -0
  266. package/src/scheduler-model.test.ts +546 -0
  267. package/src/scheduler-model.ts +853 -0
  268. package/src/scheduler-view.svelte.ts +33 -0
  269. package/src/selection.test.ts +754 -754
  270. package/src/selection.ts +600 -600
  271. package/src/server-data-source.test.ts +289 -289
  272. package/src/server-data-source.ts +413 -413
  273. package/src/sparkline.test.ts +68 -68
  274. package/src/sparkline.ts +169 -169
  275. package/src/spreadsheet.test.ts +489 -489
  276. package/src/spreadsheet.ts +312 -304
  277. package/src/static-functions.ts +11 -11
  278. package/src/subscribe.ts +38 -38
  279. package/src/svgrid-wrapper.types.ts +501 -501
  280. package/src/svgrid.behavior.test.ts +706 -706
  281. package/src/svgrid.charting.test.ts +527 -527
  282. package/src/svgrid.effect-driven-filter.svelte.test.ts +116 -0
  283. package/src/svgrid.features.test.ts +157 -157
  284. package/src/svgrid.new-features.wrapper.test.ts +251 -251
  285. package/src/svgrid.wrapper.test.ts +40 -40
  286. package/src/test-setup.ts +62 -62
  287. package/src/themes/index.ts +159 -159
  288. package/src/ui-app.types.ts +3 -0
  289. package/src/virtual.test.ts +6 -4
  290. package/src/virtualization/column-virtualizer.test.ts +27 -27
  291. package/src/virtualization/column-virtualizer.ts +30 -30
  292. package/src/virtualization/svelte-virtualizer.svelte.ts +26 -26
  293. package/src/virtualization/types.ts +30 -30
  294. package/src/virtualization/virtualizer.test.ts +47 -47
  295. package/src/virtualization/virtualizer.ts +296 -296
@@ -9,7 +9,7 @@
9
9
  * <SvPagination page={p} pageCount={20} onChange={(n) => (p = n)} />
10
10
  * ```
11
11
  */
12
- import { paginationRange } from './paginate'
12
+ import { createPagination } from './createPagination'
13
13
 
14
14
  type Props = {
15
15
  /** 1-based current page. */
@@ -38,23 +38,26 @@
38
38
  ariaLabel = 'Pagination',
39
39
  }: Props = $props()
40
40
 
41
- const items = $derived(paginationRange({ page, pageCount, siblingCount, boundaryCount }))
42
- const go = (p: number) => {
43
- if (disabled) return
44
- const next = Math.min(Math.max(p, 1), pageCount)
45
- if (next !== page) onChange?.(next)
46
- }
41
+ // Page-range math + navigation live in the shared headless core.
42
+ const pg = createPagination({
43
+ page: () => page,
44
+ pageCount: () => pageCount,
45
+ onChange,
46
+ siblingCount: () => siblingCount,
47
+ boundaryCount: () => boundaryCount,
48
+ disabled: () => disabled,
49
+ })
47
50
  </script>
48
51
 
49
- <nav class="sv-pg sv-pg--{size}" aria-label={ariaLabel}>
52
+ <nav class="sv-pg sv-pg--{size}" {...pg.navProps(ariaLabel)}>
50
53
  <ul class="sv-pg__list">
51
54
  {#if showFirstLast}
52
- <li><button type="button" class="sv-pg__btn" aria-label="First page" onclick={() => go(1)} disabled={disabled || page <= 1}>&laquo;</button></li>
55
+ <li><button type="button" class="sv-pg__btn" {...pg.firstProps()}>&laquo;</button></li>
53
56
  {/if}
54
57
  {#if showPrevNext}
55
- <li><button type="button" class="sv-pg__btn" aria-label="Previous page" onclick={() => go(page - 1)} disabled={disabled || page <= 1}>&lsaquo;</button></li>
58
+ <li><button type="button" class="sv-pg__btn" {...pg.prevProps()}>&lsaquo;</button></li>
56
59
  {/if}
57
- {#each items as it, i (typeof it === 'number' ? `p${it}` : `${it}-${i}`)}
60
+ {#each pg.items as it, i (typeof it === 'number' ? `p${it}` : `${it}-${i}`)}
58
61
  {#if it === 'ellipsis-left' || it === 'ellipsis-right'}
59
62
  <li><span class="sv-pg__ellipsis" aria-hidden="true">&hellip;</span></li>
60
63
  {:else}
@@ -62,20 +65,17 @@
62
65
  <button
63
66
  type="button"
64
67
  class="sv-pg__btn"
65
- class:is-active={it === page}
66
- aria-current={it === page ? 'page' : undefined}
67
- aria-label={`Page ${it}`}
68
- {disabled}
69
- onclick={() => go(it)}
68
+ class:is-active={pg.isActive(it)}
69
+ {...pg.pageButtonProps(it)}
70
70
  >{it}</button>
71
71
  </li>
72
72
  {/if}
73
73
  {/each}
74
74
  {#if showPrevNext}
75
- <li><button type="button" class="sv-pg__btn" aria-label="Next page" onclick={() => go(page + 1)} disabled={disabled || page >= pageCount}>&rsaquo;</button></li>
75
+ <li><button type="button" class="sv-pg__btn" {...pg.nextProps()}>&rsaquo;</button></li>
76
76
  {/if}
77
77
  {#if showFirstLast}
78
- <li><button type="button" class="sv-pg__btn" aria-label="Last page" onclick={() => go(pageCount)} disabled={disabled || page >= pageCount}>&raquo;</button></li>
78
+ <li><button type="button" class="sv-pg__btn" {...pg.lastProps()}>&raquo;</button></li>
79
79
  {/if}
80
80
  </ul>
81
81
  </nav>
@@ -31,7 +31,7 @@
31
31
  }
32
32
 
33
33
  let {
34
- value = '',
34
+ value = $bindable(''),
35
35
  onChange,
36
36
  placeholder,
37
37
  disabled = false,
@@ -58,7 +58,8 @@
58
58
 
59
59
  const pw = createPasswordInput({
60
60
  value: () => value,
61
- onChange: (v) => onChange?.(v),
61
+ // Write `value` (so `bind:value` works) AND fire `onChange` (callback users).
62
+ onChange: (v) => { value = v; onChange?.(v) },
62
63
  placeholder: () => placeholder,
63
64
  disabled: () => disabled,
64
65
  readonly: () => readonly,
@@ -20,6 +20,6 @@ type Props = SvEditorProps & {
20
20
  /** Override the built-in strings (reveal toggle + strength labels). */
21
21
  messages?: Partial<PasswordMessages>;
22
22
  };
23
- declare const SvPasswordInput: import("svelte").Component<Props, {}, "">;
23
+ declare const SvPasswordInput: import("svelte").Component<Props, {}, "value">;
24
24
  type SvPasswordInput = ReturnType<typeof SvPasswordInput>;
25
25
  export default SvPasswordInput;
@@ -27,7 +27,7 @@
27
27
  }
28
28
 
29
29
  let {
30
- value = '',
30
+ value = $bindable(''),
31
31
  onChange,
32
32
  country = 'US',
33
33
  disabled = false,
@@ -52,7 +52,8 @@
52
52
 
53
53
  const ph = createPhoneInput({
54
54
  value: () => value,
55
- onChange: (v, parts) => onChange?.(v, parts),
55
+ // Write `value` (so `bind:value` works) AND fire `onChange` (callback users).
56
+ onChange: (v, parts) => { value = v; onChange?.(v, parts) },
56
57
  country: () => country,
57
58
  disabled: () => disabled,
58
59
  readonly: () => readonly,
@@ -13,6 +13,6 @@ type Props = SvEditorProps & {
13
13
  /** Override the built-in strings (e.g. the country selector aria-label). */
14
14
  messages?: Partial<PhoneMessages>;
15
15
  };
16
- declare const SvPhoneInput: import("svelte").Component<Props, {}, "">;
16
+ declare const SvPhoneInput: import("svelte").Component<Props, {}, "value">;
17
17
  type SvPhoneInput = ReturnType<typeof SvPhoneInput>;
18
18
  export default SvPhoneInput;
@@ -1,139 +1,139 @@
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`. Flips above the trigger when there's no room below,
6
- * closes on outside-click / Escape, and animates in. Parity: Smart popover.
7
- *
8
- * ```svelte
9
- * <SvPopover>
10
- * {#snippet anchor()}<button>Open</button>{/snippet}
11
- * <p>Panel content</p>
12
- * </SvPopover>
13
- * ```
14
- */
15
- import type { Snippet } from 'svelte'
16
- import { anchoredRect, portalToBody, popIn, type AnchoredRect } from './popover'
17
- import { createDismissableLayer } from './a11y/dismissable'
18
-
19
- type Props = {
20
- /** Controlled open state (bindable). */
21
- open?: boolean
22
- onOpenChange?: (open: boolean) => void
23
- /** How the anchor opens the panel. `manual` = only `open` drives it. */
24
- trigger?: 'click' | 'hover' | 'manual'
25
- /** Estimated panel height for flip decisions. */
26
- estimatedHeight?: number
27
- /** Force a minimum panel width (else it hugs its content). */
28
- minWidth?: number
29
- /** Close when clicking outside. Default true. */
30
- closeOnOutsideClick?: boolean
31
- ariaLabel?: string
32
- /** The anchor element(s) that open the panel. */
33
- anchor?: Snippet
34
- /** Panel content. */
35
- children?: Snippet
36
- }
37
-
38
- let {
39
- open = $bindable(false),
40
- onOpenChange,
41
- trigger = 'click',
42
- estimatedHeight = 220,
43
- minWidth,
44
- closeOnOutsideClick = true,
45
- ariaLabel,
46
- anchor,
47
- children,
48
- }: Props = $props()
49
-
50
- let anchorEl = $state<HTMLSpanElement | null>(null)
51
- let panelEl = $state<HTMLDivElement | null>(null)
52
- let rect = $state<AnchoredRect>({ top: 0, left: 0, width: 0, openUpward: false })
53
-
54
- function setOpen(v: boolean) { if (v !== open) { open = v; onOpenChange?.(v) } }
55
- function toggle() { setOpen(!open) }
56
-
57
- function updatePos() {
58
- if (!anchorEl) return
59
- rect = anchoredRect(anchorEl.getBoundingClientRect(), { estimatedHeight, minWidth })
60
- }
61
-
62
- $effect(() => {
63
- if (!open) return
64
- updatePos()
65
- const rp = () => updatePos()
66
- window.addEventListener('scroll', rp, true)
67
- window.addEventListener('resize', rp)
68
- // Escape + outside-click dismissal via the shared layer stack (so a popover
69
- // nested in a dialog closes top-first). The trigger is passed alongside the
70
- // panel so clicking it toggles rather than dismiss-then-reopen.
71
- const layer = createDismissableLayer({
72
- element: () => [anchorEl, panelEl],
73
- onDismiss: () => setOpen(false),
74
- closeOnOutside: closeOnOutsideClick,
75
- })
76
- layer.activate()
77
- return () => {
78
- window.removeEventListener('scroll', rp, true)
79
- window.removeEventListener('resize', rp)
80
- layer.release()
81
- }
82
- })
83
-
84
- let hoverTimer: ReturnType<typeof setTimeout> | undefined
85
- function onEnter() { if (trigger === 'hover') { clearTimeout(hoverTimer); setOpen(true) } }
86
- function onLeave() { if (trigger === 'hover') { hoverTimer = setTimeout(() => setOpen(false), 120) } }
87
-
88
- /** Fallback accessible name for the panel when `ariaLabel` isn't given: the
89
- * anchor's own aria-label, else its trimmed text content. */
90
- function anchorFallbackLabel(): string | undefined {
91
- const label = anchorEl?.getAttribute('aria-label')
92
- if (label) return label
93
- return anchorEl?.textContent?.trim() || undefined
94
- }
95
- </script>
96
-
97
- <!-- svelte-ignore a11y_no_static_element_interactions -->
98
- <span
99
- bind:this={anchorEl}
100
- class="sv-pop__anchor"
101
- onclick={() => trigger === 'click' && toggle()}
102
- onpointerenter={onEnter}
103
- onpointerleave={onLeave}
104
- onfocusin={onEnter}
105
- onfocusout={onLeave}
106
- >
107
- {@render anchor?.()}
108
- </span>
109
-
110
- {#if open}
111
- <div
112
- bind:this={panelEl}
113
- class="sv-pop__panel"
114
- use:portalToBody
115
- use:popIn={{ up: rect.openUpward }}
116
- style:position="fixed"
117
- style:top={`${rect.top}px`}
118
- style:left={`${rect.left}px`}
119
- style:min-width={minWidth ? `${rect.width}px` : undefined}
120
- role="dialog"
121
- aria-label={ariaLabel ?? anchorFallbackLabel()}
122
- onpointerenter={onEnter}
123
- onpointerleave={onLeave}
124
- onfocusin={onEnter}
125
- onfocusout={onLeave}
126
- >
127
- {@render children?.()}
128
- </div>
129
- {/if}
130
-
131
- <style>
132
- .sv-pop__anchor { display: inline-flex; }
133
- :global(.sv-pop__panel) {
134
- z-index: 2147483646; max-width: min(92vw, 360px); padding: 12px 14px;
135
- background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a);
136
- border: 1px solid var(--sg-border, #e2e8f0); border-radius: 10px;
137
- box-shadow: 0 16px 48px -12px rgba(15, 23, 42, 0.35); font-size: 13px; line-height: 1.55;
138
- }
139
- </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`. Flips above the trigger when there's no room below,
6
+ * closes on outside-click / Escape, and animates in. Parity: Smart popover.
7
+ *
8
+ * ```svelte
9
+ * <SvPopover>
10
+ * {#snippet anchor()}<button>Open</button>{/snippet}
11
+ * <p>Panel content</p>
12
+ * </SvPopover>
13
+ * ```
14
+ */
15
+ import type { Snippet } from 'svelte'
16
+ import { anchoredRect, portalToBody, popIn, type AnchoredRect } from './popover'
17
+ import { createDismissableLayer } from './a11y/dismissable'
18
+
19
+ type Props = {
20
+ /** Controlled open state (bindable). */
21
+ open?: boolean
22
+ onOpenChange?: (open: boolean) => void
23
+ /** How the anchor opens the panel. `manual` = only `open` drives it. */
24
+ trigger?: 'click' | 'hover' | 'manual'
25
+ /** Estimated panel height for flip decisions. */
26
+ estimatedHeight?: number
27
+ /** Force a minimum panel width (else it hugs its content). */
28
+ minWidth?: number
29
+ /** Close when clicking outside. Default true. */
30
+ closeOnOutsideClick?: boolean
31
+ ariaLabel?: string
32
+ /** The anchor element(s) that open the panel. */
33
+ anchor?: Snippet
34
+ /** Panel content. */
35
+ children?: Snippet
36
+ }
37
+
38
+ let {
39
+ open = $bindable(false),
40
+ onOpenChange,
41
+ trigger = 'click',
42
+ estimatedHeight = 220,
43
+ minWidth,
44
+ closeOnOutsideClick = true,
45
+ ariaLabel,
46
+ anchor,
47
+ children,
48
+ }: Props = $props()
49
+
50
+ let anchorEl = $state<HTMLSpanElement | null>(null)
51
+ let panelEl = $state<HTMLDivElement | null>(null)
52
+ let rect = $state<AnchoredRect>({ top: 0, left: 0, width: 0, openUpward: false, maxHeight: 0, availHeight: 0 })
53
+
54
+ function setOpen(v: boolean) { if (v !== open) { open = v; onOpenChange?.(v) } }
55
+ function toggle() { setOpen(!open) }
56
+
57
+ function updatePos() {
58
+ if (!anchorEl) return
59
+ rect = anchoredRect(anchorEl.getBoundingClientRect(), { estimatedHeight, minWidth })
60
+ }
61
+
62
+ $effect(() => {
63
+ if (!open) return
64
+ updatePos()
65
+ const rp = () => updatePos()
66
+ window.addEventListener('scroll', rp, true)
67
+ window.addEventListener('resize', rp)
68
+ // Escape + outside-click dismissal via the shared layer stack (so a popover
69
+ // nested in a dialog closes top-first). The trigger is passed alongside the
70
+ // panel so clicking it toggles rather than dismiss-then-reopen.
71
+ const layer = createDismissableLayer({
72
+ element: () => [anchorEl, panelEl],
73
+ onDismiss: () => setOpen(false),
74
+ closeOnOutside: closeOnOutsideClick,
75
+ })
76
+ layer.activate()
77
+ return () => {
78
+ window.removeEventListener('scroll', rp, true)
79
+ window.removeEventListener('resize', rp)
80
+ layer.release()
81
+ }
82
+ })
83
+
84
+ let hoverTimer: ReturnType<typeof setTimeout> | undefined
85
+ function onEnter() { if (trigger === 'hover') { clearTimeout(hoverTimer); setOpen(true) } }
86
+ function onLeave() { if (trigger === 'hover') { hoverTimer = setTimeout(() => setOpen(false), 120) } }
87
+
88
+ /** Fallback accessible name for the panel when `ariaLabel` isn't given: the
89
+ * anchor's own aria-label, else its trimmed text content. */
90
+ function anchorFallbackLabel(): string | undefined {
91
+ const label = anchorEl?.getAttribute('aria-label')
92
+ if (label) return label
93
+ return anchorEl?.textContent?.trim() || undefined
94
+ }
95
+ </script>
96
+
97
+ <!-- svelte-ignore a11y_no_static_element_interactions -->
98
+ <span
99
+ bind:this={anchorEl}
100
+ class="sv-pop__anchor"
101
+ onclick={() => trigger === 'click' && toggle()}
102
+ onpointerenter={onEnter}
103
+ onpointerleave={onLeave}
104
+ onfocusin={onEnter}
105
+ onfocusout={onLeave}
106
+ >
107
+ {@render anchor?.()}
108
+ </span>
109
+
110
+ {#if open}
111
+ <div
112
+ bind:this={panelEl}
113
+ class="sv-pop__panel"
114
+ use:portalToBody
115
+ use:popIn={{ up: rect.openUpward }}
116
+ style:position="fixed"
117
+ style:top={`${rect.top}px`}
118
+ style:left={`${rect.left}px`}
119
+ style:min-width={minWidth ? `${rect.width}px` : undefined}
120
+ role="dialog"
121
+ aria-label={ariaLabel ?? anchorFallbackLabel()}
122
+ onpointerenter={onEnter}
123
+ onpointerleave={onLeave}
124
+ onfocusin={onEnter}
125
+ onfocusout={onLeave}
126
+ >
127
+ {@render children?.()}
128
+ </div>
129
+ {/if}
130
+
131
+ <style>
132
+ .sv-pop__anchor { display: inline-flex; }
133
+ :global(.sv-pop__panel) {
134
+ z-index: 2147483646; max-width: min(92vw, 360px); padding: 12px 14px;
135
+ background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a);
136
+ border: 1px solid var(--sg-border, #e2e8f0); border-radius: 10px;
137
+ box-shadow: 0 16px 48px -12px rgba(15, 23, 42, 0.35); font-size: 13px; line-height: 1.55;
138
+ }
139
+ </style>